feature-sliced / documentation

🍰 Architectural methodology for frontend projects
https://feature-sliced.design
MIT License
1.48k stars 155 forks source link

EDITING-423: Purge redundant links and reorder the content #432

Closed illright closed 2 years ago

illright commented 2 years ago

CHANGELOG

Много чего тут поменялось:

  1. Убрал ссылки из первого параграфа. Причина в двух словах: эти ссылки вели в никуда. Для ссылки важно не только то, куда она ведет, но еще и откуда, чтоб при переходе по ней было понятно, какой информационный гэп заполняет эта ссылка.
  2. Уточнил, куда ведет ссылка под диаграммой
  3. Объединил разделы "Обзор" и "Преимущества" Ранее в разделе "Преимущества" была фраза "Для этого она вводит ряд концепций и абстракций, на которых может базироваться архитектура от проекта к проекту. Отсюда получаем ряд преимуществ", в которой не было понятно, какие концепты и абстракции, так что слово "отсюда" было не очень соединенным.
  4. Убрал большую часть карточек Они просто дублировали навигационный хедер, и не давали никаких советов о том, кому стоит переходить именно по этой карточке. Я считаю, что главным образом нужны только две карточки – на логическое продолжение страницы и на примеры.

Еще одна проблема: Docusaurus сам предоставляет переход на следующую страницу, поэтому эти карточки немного дублируют этот функционал, что не очень хорошо. Плюс там между ними есть виджет лайков-дизлайков документации, в ценности которого я тоже немного сомневаюсь.

Скриншот, где видно дублирование функционала дублирование функционала
Полностраничный скриншот результата ![полностраничный скриншот результата](https://user-images.githubusercontent.com/15035286/151941985-3e4e0640-ac5f-45d2-afcc-09994b019067.png)

Closes #423

Checklist

azinit commented 2 years ago

Лучше в след раз темплейт не убирай пож)

illright commented 2 years ago

Лучше в след раз темплейт не убирай пож)

Почему?

azinit commented 2 years ago

Лучше в след раз темплейт не убирай пож)

Почему?

В темплейте подробно описано почему :)

image
azinit commented 2 years ago

@RinAkaia @unordinarity @AlexandrHoroshih вы там где?)

illright commented 2 years ago

@azinit порезолви, пожалуйста, треды, в которых достигнут консенсус, а то голова уже идет кругом)

azinit commented 2 years ago

@azinit порезолви, пожалуйста, треды, в которых достигнут консенсус, а то голова уже идет кругом)

Порезолвил))

azinit commented 2 years ago

@illright Мб добьем и вольем? Вроде по этому PR чуть чуть осталось 🤔 (в рамках задачи и замечаний)

illright commented 2 years ago

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

azinit commented 2 years ago

@illright Спасибо отдельно, что вносил правки, даже когда не до конца был согласен!

azinit commented 2 years ago

@all-contributors please add @illright for ideas

allcontributors[bot] commented 2 years ago

@azinit

I've put up a pull request to add @illright! :tada: