search

EightM / JavaBackendStartGuide

Руководство по вкатыванию в backend разработку на Java для почти начинающих и сочувствующих.
Mozilla Public License 2.0
445 stars 66 forks source link

quarkus basics #33

Closed lasteris closed 1 year ago

lasteris commented 1 year ago

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

lasteris commented 1 year ago

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

EightM commented 1 year ago

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

EightM commented 1 year ago

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

lasteris commented 1 year ago

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

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

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

lasteris commented 1 year ago

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

lasteris commented 1 year ago

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

EightM commented 1 year ago

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

EightM commented 1 year ago

@lasteris спасибо!

lasteris commented 1 year ago

@lasteris спасибо!

взаимно )