quarkus basics by lasteris · Pull Request #33 · EightM/JavaBackendStartGuide

lasteris · 2023-08-06T09:58:20Z

Добавил краткое описание про Quarkus: )
Думаю стоит его добавить.
Правда надо бы чтоб построение фраз и пунктуацию кто-нибудь заверил (

EightM · 2023-08-06T10:13:01Z

@@ -0,0 +1,32 @@
+### Quarkus
+
+[Quarkus](https://quarkus.io/) - наиболее популярный "FullStack Framework" после [Spring](https://spring.io/). Детище **RedHat**, вышедшее в Opensource. Проект насчитывает уже третий мажорный релиз и даже обзавелся LTS-версией. В отличии от того же Spring, Quarkus построен на реализации [JAX-RS](https://en.wikipedia.org/wiki/Jakarta_RESTful_Web_Services) от [Resteasy](https://resteasy.dev/), из которой позже, специально для Quarkus, выросла реализация [Resteasy reactive](https://quarkus.io/guides/resteasy-reactive), построенная на [Vert.x](https://vertx.io/).  Тот факт, что Quarkus основан уже на давно существующей реализации JAX-RS, стал подспорьем для перехода множества компаний в миграции своих сервисов с [Wildfly](https://www.wildfly.org/) без каких-либо тяжелых усилий.


наиболее популярный после Spring

Желательно указать авторитетный источник. Например, "наиболее популярный framework после Spring по версии XXX"

EightM · 2023-08-06T10:13:46Z

@@ -0,0 +1,32 @@
+### Quarkus
+
+[Quarkus](https://quarkus.io/) - наиболее популярный "FullStack Framework" после [Spring](https://spring.io/). Детище **RedHat**, вышедшее в Opensource. Проект насчитывает уже третий мажорный релиз и даже обзавелся LTS-версией. В отличии от того же Spring, Quarkus построен на реализации [JAX-RS](https://en.wikipedia.org/wiki/Jakarta_RESTful_Web_Services) от [Resteasy](https://resteasy.dev/), из которой позже, специально для Quarkus, выросла реализация [Resteasy reactive](https://quarkus.io/guides/resteasy-reactive), построенная на [Vert.x](https://vertx.io/).  Тот факт, что Quarkus основан уже на давно существующей реализации JAX-RS, стал подспорьем для перехода множества компаний в миграции своих сервисов с [Wildfly](https://www.wildfly.org/) без каких-либо тяжелых усилий.


Проект насчитывает уже третий мажорный релиз и даже обзавелся LTS-версией.

Кажется, что для новичка эта информация не несет какой-то полезной нагрузки

Хорошо, подумаю. В данном абзаце я хотел описать мотивацию почему его многие используют и зачем в его сторону смотреть )

EightM · 2023-08-06T10:17:43Z

@@ -0,0 +1,32 @@
+### Quarkus
+
+[Quarkus](https://quarkus.io/) - наиболее популярный "FullStack Framework" после [Spring](https://spring.io/). Детище **RedHat**, вышедшее в Opensource. Проект насчитывает уже третий мажорный релиз и даже обзавелся LTS-версией. В отличии от того же Spring, Quarkus построен на реализации [JAX-RS](https://en.wikipedia.org/wiki/Jakarta_RESTful_Web_Services) от [Resteasy](https://resteasy.dev/), из которой позже, специально для Quarkus, выросла реализация [Resteasy reactive](https://quarkus.io/guides/resteasy-reactive), построенная на [Vert.x](https://vertx.io/).  Тот факт, что Quarkus основан уже на давно существующей реализации JAX-RS, стал подспорьем для перехода множества компаний в миграции своих сервисов с [Wildfly](https://www.wildfly.org/) без каких-либо тяжелых усилий.


Quarkus построен на реализации [JAX-RS]

Здесь и далее идет обилие сложных технических терминов и аббревиатур. Ссылки на википедию конечно помогут, но возможно получится описать более простым языком ключевое отличие от Spring? Что-то в духе "Quarkus такой же классный как Spring, но еще и реактивный". И в паре предложений описать, что за реактивность такая

EightM · 2023-08-06T10:20:26Z

@@ -0,0 +1,32 @@
+### Quarkus
+
+[Quarkus](https://quarkus.io/) - наиболее популярный "FullStack Framework" после [Spring](https://spring.io/). Детище **RedHat**, вышедшее в Opensource. Проект насчитывает уже третий мажорный релиз и даже обзавелся LTS-версией. В отличии от того же Spring, Quarkus построен на реализации [JAX-RS](https://en.wikipedia.org/wiki/Jakarta_RESTful_Web_Services) от [Resteasy](https://resteasy.dev/), из которой позже, специально для Quarkus, выросла реализация [Resteasy reactive](https://quarkus.io/guides/resteasy-reactive), построенная на [Vert.x](https://vertx.io/).  Тот факт, что Quarkus основан уже на давно существующей реализации JAX-RS, стал подспорьем для перехода множества компаний в миграции своих сервисов с [Wildfly](https://www.wildfly.org/) без каких-либо тяжелых усилий.


Тот факт, что Quarkus основан уже на давно существующей реализации JAX-RS...

Опять же, новичок может быть и не в курсе, о том, что такое Wildfly и почему с него надо было переезжать. Получится ли тут расписать более простым языком? В духе "раньше сидели на X и страдали из-за Y, а потом вышел Quarkus и благодаря его киллер фиче Z компании побежали на него мигрировать"?

да, подумаю

EightM · 2023-08-06T10:20:59Z

+### Quarkus
+
+[Quarkus](https://quarkus.io/) - наиболее популярный "FullStack Framework" после [Spring](https://spring.io/). Детище **RedHat**, вышедшее в Opensource. Проект насчитывает уже третий мажорный релиз и даже обзавелся LTS-версией. В отличии от того же Spring, Quarkus построен на реализации [JAX-RS](https://en.wikipedia.org/wiki/Jakarta_RESTful_Web_Services) от [Resteasy](https://resteasy.dev/), из которой позже, специально для Quarkus, выросла реализация [Resteasy reactive](https://quarkus.io/guides/resteasy-reactive), построенная на [Vert.x](https://vertx.io/).  Тот факт, что Quarkus основан уже на давно существующей реализации JAX-RS, стал подспорьем для перехода множества компаний в миграции своих сервисов с [Wildfly](https://www.wildfly.org/) без каких-либо тяжелых усилий.
+Как и Spring Framework, Quarkus из коробки поддерживает большинство технологий, в таком виде, чтобы с ними было комфортно работать в рамках экосистемы Quarkus.


поддерживает большинство технологий

Каких?

EightM · 2023-08-06T10:21:21Z

+### Quarkus
+
+[Quarkus](https://quarkus.io/) - наиболее популярный "FullStack Framework" после [Spring](https://spring.io/). Детище **RedHat**, вышедшее в Opensource. Проект насчитывает уже третий мажорный релиз и даже обзавелся LTS-версией. В отличии от того же Spring, Quarkus построен на реализации [JAX-RS](https://en.wikipedia.org/wiki/Jakarta_RESTful_Web_Services) от [Resteasy](https://resteasy.dev/), из которой позже, специально для Quarkus, выросла реализация [Resteasy reactive](https://quarkus.io/guides/resteasy-reactive), построенная на [Vert.x](https://vertx.io/).  Тот факт, что Quarkus основан уже на давно существующей реализации JAX-RS, стал подспорьем для перехода множества компаний в миграции своих сервисов с [Wildfly](https://www.wildfly.org/) без каких-либо тяжелых усилий.
+Как и Spring Framework, Quarkus из коробки поддерживает большинство технологий, в таком виде, чтобы с ними было комфортно работать в рамках экосистемы Quarkus.


в таком виде

В каком?)

EightM · 2023-08-06T10:21:54Z

+
+[Quarkus](https://quarkus.io/) - наиболее популярный "FullStack Framework" после [Spring](https://spring.io/). Детище **RedHat**, вышедшее в Opensource. Проект насчитывает уже третий мажорный релиз и даже обзавелся LTS-версией. В отличии от того же Spring, Quarkus построен на реализации [JAX-RS](https://en.wikipedia.org/wiki/Jakarta_RESTful_Web_Services) от [Resteasy](https://resteasy.dev/), из которой позже, специально для Quarkus, выросла реализация [Resteasy reactive](https://quarkus.io/guides/resteasy-reactive), построенная на [Vert.x](https://vertx.io/).  Тот факт, что Quarkus основан уже на давно существующей реализации JAX-RS, стал подспорьем для перехода множества компаний в миграции своих сервисов с [Wildfly](https://www.wildfly.org/) без каких-либо тяжелых усилий.
+Как и Spring Framework, Quarkus из коробки поддерживает большинство технологий, в таком виде, чтобы с ними было комфортно работать в рамках экосистемы Quarkus.
+Если вы вдруг испугались, что придется заново учить новые ORM, JDBC, Logging-Framework'и, то спещу огорчить тут вы увидите тот же [Hibernate](https://quarkus.io/guides/hibernate-orm-panache), [SLF4J](https://quarkus.io/guides/logging), [Datasource](https://quarkus.io/guides/datasource) и многое другое. Причем, работать с ними, возможно, будет даже [удобнее](https://quarkus.io/guides/logging#simplified-logging) чем в Spring. 


Если вы

ты

EightM · 2023-08-06T10:22:16Z

+
+[Quarkus](https://quarkus.io/) - наиболее популярный "FullStack Framework" после [Spring](https://spring.io/). Детище **RedHat**, вышедшее в Opensource. Проект насчитывает уже третий мажорный релиз и даже обзавелся LTS-версией. В отличии от того же Spring, Quarkus построен на реализации [JAX-RS](https://en.wikipedia.org/wiki/Jakarta_RESTful_Web_Services) от [Resteasy](https://resteasy.dev/), из которой позже, специально для Quarkus, выросла реализация [Resteasy reactive](https://quarkus.io/guides/resteasy-reactive), построенная на [Vert.x](https://vertx.io/).  Тот факт, что Quarkus основан уже на давно существующей реализации JAX-RS, стал подспорьем для перехода множества компаний в миграции своих сервисов с [Wildfly](https://www.wildfly.org/) без каких-либо тяжелых усилий.
+Как и Spring Framework, Quarkus из коробки поддерживает большинство технологий, в таком виде, чтобы с ними было комфортно работать в рамках экосистемы Quarkus.
+Если вы вдруг испугались, что придется заново учить новые ORM, JDBC, Logging-Framework'и, то спещу огорчить тут вы увидите тот же [Hibernate](https://quarkus.io/guides/hibernate-orm-panache), [SLF4J](https://quarkus.io/guides/logging), [Datasource](https://quarkus.io/guides/datasource) и многое другое. Причем, работать с ними, возможно, будет даже [удобнее](https://quarkus.io/guides/logging#simplified-logging) чем в Spring. 


спещу

Ш

EightM · 2023-08-06T10:25:27Z

+
+#### Документация
+
+При изучении таких Framework'ов как Spring, Quarkus, Helidon, Micronaut...и тд. В первую очередь встает вопрос о документации.


...и тд. В первую очередь

и т.д. обычно заканчивает предложение, использование его в середине несколько нарушает ритм чтения. Возможно стоит просто его убрать и заменить обычной запятой.

EightM · 2023-08-06T10:29:14Z

+#### Документация
+
+При изучении таких Framework'ов как Spring, Quarkus, Helidon, Micronaut...и тд. В первую очередь встает вопрос о документации.
+Документация Quarkus не должна оставить равнодушным. Стоит просто зайти на [страницу](https://quarkus.io/guides/) и наслаждаться. Там вы найдете как короткие вводные статьи для новичков о том, как использовать тот или иной Framework в рамках Quarkus, так и концепты внутреннего устройства проекта, и, наконец Reference'ые подробнейшие статьи для продолжающих разработчиков.


В предыдущем предложении ты словом "документация" заканчиваешь предложение и тут же этим же словом его начинаешь. Стоит перефразировать, например "В первую очередь встает вопрос поиска хорошей документации. В случае Quarkus, она не оставит никого равнодушным, стоит просто зайти на страницу..."

Такие моменты хорошо ловятся, если мысленно прямо на каждую точку ставить паузу. Если чувствуешь, что поток чтения обрывается прямо слишком часто, как будто тебя одергивают, значит возможно стоит подумать в сторону расширения предложения. Но не слишком много :)

EightM · 2023-08-06T10:29:44Z

+#### Утилиты
+
+Spring имеет такую замечательную утилиту [Spring Initializr](https://start.spring.io/) для генерации и первичной настройки проекта. 
+В Свою очередь, Quarkus предоставляет Web-интерфейс со схожим функционалом [code.quarkus.io](https://code.quarkus.io/).


Свою

лишняя заглавная буква

EightM · 2023-08-06T10:31:10Z

+#### Утилиты
+
+Spring имеет такую замечательную утилиту [Spring Initializr](https://start.spring.io/) для генерации и первичной настройки проекта. 
+В Свою очередь, Quarkus предоставляет Web-интерфейс со схожим функционалом [code.quarkus.io](https://code.quarkus.io/).


Возможно стоит чуть расширить? "...предоставляет Web-интерфейс со схожим функционалом, в котором ты без проблем сможешь накидать необходимые тебе модули, зависимости и сразу получить готовую сборку проекта"

EightM · 2023-08-06T10:34:46Z

+
+#### Сообщество
+
+Стоит отметить, что у сообщества [Quarkus](https://quarkus.io/) есть такой феномен как [Quarkiverse](https://quarkiverse.io/), куда множество компаний по всему миру выкладывают собственные расширения над [Quarkus](https://quarkus.io/).


такой феномен как... куда множество компаний

Построено так, что компании выкладывают расширения прямо в феномен.
Возможно стоит перефразировать как "такой феномен как Quarkiverse. Это сайт/хаб/портал, куда множество компаний по всему миру..."

EightM · 2023-08-06T10:35:14Z

+
+Стоит отметить, что у сообщества [Quarkus](https://quarkus.io/) есть такой феномен как [Quarkiverse](https://quarkiverse.io/), куда множество компаний по всему миру выкладывают собственные расширения над [Quarkus](https://quarkus.io/).
+Уже сейчас, при желании, там можно обнаружить поддержку большинства актуальных технологий "из коробки".
+Например, если вам необходимо настроить в проекте взаимодействие по протоколу [SOAP](https://ru.wikipedia.org/wiki/SOAP), то достаточно обратиться сюда [quarkus-cxf extension](https://docs.quarkiverse.io/quarkus-cxf/dev/index.html). Там вы найдете все необходимое.


вам

тебе

EightM · 2023-08-06T10:36:23Z

+Стоит отметить, что у сообщества [Quarkus](https://quarkus.io/) есть такой феномен как [Quarkiverse](https://quarkiverse.io/), куда множество компаний по всему миру выкладывают собственные расширения над [Quarkus](https://quarkus.io/).
+Уже сейчас, при желании, там можно обнаружить поддержку большинства актуальных технологий "из коробки".
+Например, если вам необходимо настроить в проекте взаимодействие по протоколу [SOAP](https://ru.wikipedia.org/wiki/SOAP), то достаточно обратиться сюда [quarkus-cxf extension](https://docs.quarkiverse.io/quarkus-cxf/dev/index.html). Там вы найдете все необходимое.
+Также, по собственному опыту, могу сказать что сообщество глубоко заинтересовано и открыто к решению проблем. При желании можно задать любой вопрос в [чате](https://quarkusio.zulipchat.com/), в котором сидят разработчики [Quarkus](https://quarkus.io/) и с охотой отвечают на любой вопрос.


на любой вопрос

любые вопросы

lasteris · 2023-08-06T10:38:29Z

Такое количество огрех, даже стыдно как-то :)
Сегодня-завтра постараюсь выложить правки по замечаниям

EightM · 2023-08-06T10:41:23Z

@lasteris спасибо за реквест! Большинство замечаний к стилистике, а не к содержанию, так что ты молодец.
Из общих замечаний, обрати внимание на два момента

в руководстве используется везде обращение на "ты"
в рамках раздела, стоит использовать одну и ту же ссылку не более одного раза. Например, не нужно несколько раз на термин Quarkus прикреплять ссылку на сайт. Логика в том, что пользователь читая документ по порядку, впервые встретив термин может захотеть открыть ссылку. В последующие разы она ему уже не нужна, потому что он ее либо уже открыл, либо прочитал

EightM · 2023-08-06T10:42:49Z

@lasteris А, ну и мои примеры по замене не стоит рассматривать как эталон, потому что я сам далеко не писатель. Это скорее повод еще раз подумать над формой предложения.

lasteris · 2023-08-06T10:42:56Z

@lasteris спасибо за реквест! Большинство замечаний к стилистике, а не к содержанию, так что ты молодец.
Из общих замечаний, обрати внимание на два момента

в руководстве используется везде обращение на "ты"

в рамках раздела, стоит использовать одну и ту же ссылку не более одного раза. Например, не нужно несколько раз на термин Quarkus прикреплять ссылку на сайт. Логика в том, что пользователь читая документ по порядку, впервые встретив термин может захотеть открыть ссылку. В последующие разы она ему уже не нужна, потому что он ее либо уже открыл, либо прочитал

да, хорошо, спасибо за такую обратную связь 🙂

lasteris · 2023-08-08T09:53:03Z

@EightM меня немного унесло :)
Считай полностью переписал.
Можешь глянуть визуально как это, я пока выложил в моем fork'e
https://lasteris.github.io/JavaBackendStartGuide/quarkus/
Жду ревью 🙂

заменил обращения к читателю с вы на ты

опечатки, обезличенность (кроме личного опыта)

lasteris · 2023-08-08T12:34:36Z

добавил ещё пару коммитов. опечатки убрал и немного обезличил текст.

закрыл скобку

framework - заменено, так как в русском языке присутствует обрусевший аналог. исправлены опечатки

EightM · 2023-08-09T14:44:25Z

+Вместо этого, он предлагает использовать уже давно существующую в рамках мира backend web-разработки реализацию спецификации [Jakarta REST (ранее известная как JAX-RS)](https://jakarta.ee/specifications/restful-ws/3.1/jakarta-restful-ws-spec-3.1.html), известной как [Resteasy](https://resteasy.dev/).
+ В сущности, это означает, что разработчикам не пришлось особенно много усилий прилагать, чтобы уйти от устаревшего формата разработки.
+Конечно же, это можно было сделать и с помощью Spring Boot, но количество усилий несоизмеримо.
+По опыту могу сказать, что типовой микросервис можно перенести c сервлетного JAX-RS на Quarkus даже за 5 минут (конечно же, это средняя температура по больнице).


По опыту могу сказать

На мой взгляд, личные переживания и опыт автора не слишком подходят к обезличенному формату руководства. Дополнять руководство может неограниченный круг лиц, поэтому выражение личного мнения может превратить текст в солянку.

Так что стоит заменять личное, на рекомендацию. Смысл тот же, только источник рекомендации обезличен.

Стоит изменить на просто "Типовой микросервис можно перенести..."

готово

EightM · 2023-08-09T14:46:13Z

+которые подробнее расскажут как писать [REST сервисы](https://quarkus.io/guides/rest-json), в том числе [реактивно](https://quarkus.io/guides/getting-started-reactive). 
+Также, покажут как упростить разработку в твоей любимой [IDE](https://quarkus.io/guides/ide-tooling) и многое другое.
+
+#### Личный опыт


Раздел личного опыта стоит убрать, оставив абзац про то, где можно найти истории миграции на quarkus

готово

EightM · 2023-08-09T14:47:35Z

@lasteris Вторая версия текста получилась гораздо более живой и человечной, было приятно читать. Добавил два замечания, поправишь и можно вливать

еще немного придал тексту обезличенности

EightM · 2023-08-09T18:38:25Z

@lasteris спасибо!

lasteris · 2023-08-09T18:39:54Z

@lasteris спасибо!

взаимно )

quarkus basics

5cf4f7f

EightM reviewed Aug 6, 2023

View reviewed changes

quarkus pr review

4c8083a

lasteris added 2 commits August 8, 2023 13:50

Update quarkus.md

2412cf0

заменил обращения к читателю с вы на ты

Update quarkus.md

45aac7c

опечатки, обезличенность (кроме личного опыта)

lasteris added 2 commits August 8, 2023 15:40

Update quarkus.md

a414813

закрыл скобку

Update quarkus.md

5dc4b80

framework - заменено, так как в русском языке присутствует обрусевший аналог. исправлены опечатки

EightM reviewed Aug 9, 2023

View reviewed changes

почистил раздел с опытом

0bdef27

еще немного придал тексту обезличенности

EightM merged commit c78f5de into EightM:develop Aug 9, 2023

		@@ -0,0 +1,32 @@
		### Quarkus

		[Quarkus](https://quarkus.io/) - наиболее популярный "FullStack Framework" после [Spring](https://spring.io/). Детище RedHat, вышедшее в Opensource. Проект насчитывает уже третий мажорный релиз и даже обзавелся LTS-версией. В отличии от того же Spring, Quarkus построен на реализации [JAX-RS](https://en.wikipedia.org/wiki/Jakarta_RESTful_Web_Services) от [Resteasy](https://resteasy.dev/), из которой позже, специально для Quarkus, выросла реализация [Resteasy reactive](https://quarkus.io/guides/resteasy-reactive), построенная на [Vert.x](https://vertx.io/). Тот факт, что Quarkus основан уже на давно существующей реализации JAX-RS, стал подспорьем для перехода множества компаний в миграции своих сервисов с [Wildfly](https://www.wildfly.org/) без каких-либо тяжелых усилий.


		#### Документация

		При изучении таких Framework'ов как Spring, Quarkus, Helidon, Micronaut...и тд. В первую очередь встает вопрос о документации.


		#### Сообщество

		Стоит отметить, что у сообщества [Quarkus](https://quarkus.io/) есть такой феномен как [Quarkiverse](https://quarkiverse.io/), куда множество компаний по всему миру выкладывают собственные расширения над [Quarkus](https://quarkus.io/).

Conversation

lasteris commented Aug 6, 2023

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

EightM Aug 6, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

lasteris commented Aug 6, 2023

Uh oh!

EightM commented Aug 6, 2023

Uh oh!

EightM commented Aug 6, 2023

Uh oh!

lasteris commented Aug 6, 2023

Uh oh!

lasteris commented Aug 8, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

lasteris commented Aug 8, 2023 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

EightM commented Aug 9, 2023

Uh oh!

EightM commented Aug 9, 2023

Uh oh!

lasteris commented Aug 9, 2023

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

EightM Aug 6, 2023 •

edited

Loading

lasteris commented Aug 8, 2023 •

edited

Loading

lasteris commented Aug 8, 2023 •

edited

Loading