-
Notifications
You must be signed in to change notification settings - Fork 178
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
EDITING-423: Purge redundant links and reorder the content #432
EDITING-423: Purge redundant links and reorder the content #432
Conversation
Лучше в след раз темплейт не убирай пож) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Остальное позже гляну
Видно, что стало ссылок поменьше, и в целом Intro стал почище
Но по NavCards прям подискутировать надо))
website/i18n/ru/docusaurus-plugin-content-docs/current/intro.mdx
Outdated
Show resolved
Hide resolved
Почему? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ознакомился внимательней
В целом оч даже гуд, но есть что улучшить))
(пока прям "блокер" - это удаленные карточки в конце)
website/i18n/ru/docusaurus-plugin-content-docs/current/intro.mdx
Outdated
Show resolved
Hide resolved
website/i18n/ru/docusaurus-plugin-content-docs/current/intro.mdx
Outdated
Show resolved
Hide resolved
website/i18n/ru/docusaurus-plugin-content-docs/current/intro.mdx
Outdated
Show resolved
Hide resolved
website/i18n/ru/docusaurus-plugin-content-docs/current/intro.mdx
Outdated
Show resolved
Hide resolved
website/i18n/ru/docusaurus-plugin-content-docs/current/intro.mdx
Outdated
Show resolved
Hide resolved
@RinAkaia @unordinarity @AlexandrHoroshih вы там где?) |
Removes the negative connotation
@azinit порезолви, пожалуйста, треды, в которых достигнут консенсус, а то голова уже идет кругом) |
Порезолвил)) |
@illright Мб добьем и вольем? Вроде по этому PR чуть чуть осталось 🤔 |
Прямо сейчас мне немного не до этого, горит парочка других вещей. В ближайшие дни вернусь |
Благодаря этому сохраняется баланс между соблюдением принципа **DRY** и возможностью адаптировать модуль под разные цели. | ||
|
||
- **Устойчивость к изменениям и рефакторингу** | ||
Каждый компонент архитектуры имеет свое назначение и предсказуемый список зависимостей. | ||
Благодаря этому приложение можно модифицировать под новые требования без непредвиденных последствий. | ||
Один модуль не может использовать другой модуль, расположенный на том же слое или на слоях выше. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Вынужденная мера, исключительно чтобы поскорей закрыть PR
(лучше до такого не доводить)
Если есть несогласие, то предлагаю на некст итерациях обсудить 🤔
А зачем? (не для холиваров)
-
Я/МЫ Слайс
Я почти уговорил себя, чтобы поскорее закрыть PR - но так резало это "слайс" в месте, где у человека должен быть ответ на вопрос "А в чем ваше преимущество? Как ваш способ связывать модулей может улучшить ситуацию?"И тут мы такие "чувак, мы тут слайсеры, у нас нет слова "модуль", онли "слайс"
Это очень отбивает кмк
-
Too Confused
Также заметил, что при "рефакторинге и мердже" сильно сбился изначальный смысл абзацев, так что свапнул предложения "ближе к канону"
(можем в дальнейшем, опять же, обсудить твои предложения)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Не, окей, все норм звучит)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ура, наконец вливаем))
Надеюсь мы друг друга правильно поняли в контексте "радикальности и своевременности изменений"
Сам видишь к чему приводит 😏
@illright Спасибо отдельно, что вносил правки, даже когда не до конца был согласен! |
@all-contributors please add @illright for ideas |
I've put up a pull request to add @illright! 🎉 |
CHANGELOG
Много чего тут поменялось:
Причина в двух словах: эти ссылки вели в никуда. Для ссылки важно не только то, куда она ведет, но еще и откуда, чтоб при переходе по ней было понятно, какой информационный гэп заполняет эта ссылка.
Ранее в разделе "Преимущества" была фраза "Для этого она вводит ряд концепций и абстракций, на которых может базироваться архитектура от проекта к проекту. Отсюда получаем ряд преимуществ", в которой не было понятно, какие концепты и абстракции, так что слово "отсюда" было не очень соединенным.
Они просто дублировали навигационный хедер, и не давали никаких советов о том, кому стоит переходить именно по этой карточке. Я считаю, что главным образом нужны только две карточки – на логическое продолжение страницы и на примеры.
Еще одна проблема: Docusaurus сам предоставляет переход на следующую страницу, поэтому эти карточки немного дублируют этот функционал, что не очень хорошо. Плюс там между ними есть виджет лайков-дизлайков документации, в ценности которого я тоже немного сомневаюсь.
Скриншот, где видно дублирование функционала
Полностраничный скриншот результата
Closes #423
Checklist