<aside> ⚠️ Что точно должны разобрать Прийти к согласию по основным вопросам по доке FSD
</aside>
Многие разделы между собой очень похожи, из-за чего хочется их схлопнуть И с некоторыми действительно хочется так поступить, а остальные - требуют доработки, чтобы такого ощущения не возникало
Concepts и About - очень похожи по “эдвенседности”, и надо это поправить, оставив About “для мета-инфы”, а Concepts - как единый справочник по понятиям методология (не углубляясь в “почему так”)Concepts и Guides - тоже местами очень похожи, но скорее контент прорабатыватьConcepts и Reference - практически идентичны и по UX и по диатакис, их надо поскорее схлопнутьТекущий туториал никак не назовешь “быстрым стартом”, т.к. содержит много деталей (для сеньоров - избыточно, для джунов - недостаточно) Вдобавок, он слишком завязан на React, что сбивает с толку вьюшников/ангулярщиков и т.п.
Есть предложение, оставить в туториале только визуальное донесение общих идей, без такой привязки к коду Но при этом надо как-то ссылаться на тех.реализацию (с ссылками на разборы примеров для разных стеков и в целом с отсылками к получаемой структуре) И в целом, оставлять в туториале возможность “набить руку и прочувствовать FSD”
При таком подходе людям нечего будет набрасывать на “техническую реализацию”, т.к. это полноценно реализовано будет уже в /guides
Драфт статьи на хабре от @illright
Для FSD возможно потребуется несколько туториалов, для разных целей (для джунов/сеньоров, для разработчиков/дизайнеров/QA, для старта/миграции - надо подумать какие оставить ,чтобы GetStarted не разбух)
Некоторые статьи не нужны в GetStarted Тот же Motivation, который положить бы в About Что-то из туториала можно положить в гайды, облегчив при этом сам GetStarted