FSDCUR: Begin writing the new tutorial #574
Conversation
✅ Deploy Preview for pr-fsd ready!
To edit notification comments on pull requests, go to your Netlify site settings. |
i18n/en/docusaurus-plugin-content-docs/current/get-started/tutorial.mdx
Outdated
Show resolved
Hide resolved
✅ Deploy Preview for current-feature-sliced ready!
To edit notification comments on pull requests, go to your Netlify site settings. |
There was a problem hiding this comment.
nitpick: Очепятка походу)
- pages/edit-node/ui/
+ pages/edit-note/ui/There was a problem hiding this comment.
Ну фичи и сущности работают с note (заметкой), а страница почему-то с node (с какой-то нодой, цепочкой)
Ощущение что это опечатка
There was a problem hiding this comment.
а, блин, теперь понял)) да, это опечатка
There was a problem hiding this comment.
praise: Сам туториал пушка, тот самый визуальный которого не хватало!
There was a problem hiding this comment.
thoughts: Но все еще главная проблема при использовании FSD - это умение умеренно и постепенно затаскивать методологию к себе в голову и проект
Т.е. люди просто берут к себе в проект слой entities/features, даже не понимая зачем им это особо нужно
(даже если в соло, даже если в доке напишем - пока они сами не настрадаются настолько, сколько нужно чтоб понять необходимость фич - им выделение фич не будет давать пользы - см. также #pain_driven_development)
Говорю это опираясь на наши внутренние дискусии кортимы, консультации и вопросы в чате
There was a problem hiding this comment.
suggestion: Получится ли в этот распорядок туториала (и твой план в целом) добавить визуально эту идею ниже?
- сначала затаскиваются в проект
apppageswidgetsshared
- потом
entities
- и в конце уже
features
There was a problem hiding this comment.
не хочется чтоб ломало твой план по туториалу, но мб будут мысли как эту идею учесть в туториале
(чтоб люди опять не задавались вопросом что есть фича и зачем нужна фича, когда есть виджеты)
There was a problem hiding this comment.
да, это самый сложный коммент просто, про него отдельно подумаю
There was a problem hiding this comment.
Возможно твой туториал стоит оставить как есть, но сделать другой туториал/гайд где именно про этапы затаскивания говорится (желательно тоже в get-started чтоб лежало и было перед глазами)
UPD: Т.е. мб я зря думаю запихать побольше в туториал, который должен больше концепции объяснять чем этапы затаскивания в проект и голову 🤔
There was a problem hiding this comment.
Я тут скорее мнения, что хочется объяснить основные принципы ФСД в туториале, т.е. что такое бизнес-домен, что такое value для пользователя, как композировать компоненты. Для этого нам нужно рассказать про entities и features. Надеюсь таким образом отсечь вопросы в духе "а нотификейшн попап это фича?".
Однако размышление про то, что на маленьких проектах нахрен не нужны фичи, вполне здравое. Собственно, аппка в туториале такая простая, что она как раз показывает, насколько там не нужны фичи (или даже сущности, по факту). Поэтому я за то, чтоб после этого фундаментального туториала пустить гайд о том, как сделать нормально, без усложнений. Подумаю над подводкой к нему
There was a problem hiding this comment.
Супер, спасибо за дельные размышления по теме 🚀
| { | ||
| url: "https://samokat.tech/", | ||
| src: "samokat.svg", | ||
| alt: "Samokat.tech", |
There was a problem hiding this comment.
thoughts: current бы подлить, т.к. лого самоката уже затащили
| version: VERSIONS.V2, | ||
| updatedAt: "2023-04-24", | ||
| tech: ["react", "redux-toolkit", "typescript", "vite"], | ||
| }, |
There was a problem hiding this comment.
thoughts: И это в current уже тоже должно быть
azinit
changed the title
|
This PR is problematic to get up to date now, but I don't want to force push so that we don't lose comment history. I'll create a new one for this tutorial |
Background
Changelog