diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/atomic-design.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/atomic-design.mdx index f307d7e5a1..c7df7b6761 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/atomic-design.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/atomic-design.mdx @@ -6,4 +6,19 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Atomic Design - \ No newline at end of file + + +## About the approach + +## About applicability in the frontend + +## Methodology position + +> About compatibility, applicability in methodology and scope of responsibility, mapping layers + +## See also + +- [Atomic Design Methodology](https://atomicdesign.bradfrost.com/table-of-contents/) +- [(Thread) About applicability in shared / ui](https://t.me/feature_sliced/1653) +- [(Video) Briefly about Atomic Design](https://youtu.be/Yi-A20x2dcA) +- [(Talk) Ilya Azin - Feature Sliced (frament about Atomic Design)](https://youtu.be/SnzPAr_FJ7w?t=587) diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/big-ball-of-mud.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/big-ball-of-mud.mdx index aef3785bc8..6b003426c0 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/big-ball-of-mud.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/big-ball-of-mud.mdx @@ -6,4 +6,20 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Big Ball of Mud - \ No newline at end of file + + +## What is it + +## Why is it so common + +## When it starts to bring problems + +## What to do + +> And how does Featureclicked help in this + +## See also + +- [(Article) Oleg Sonin - Last words on UI architecture before an AI takes over](https://oleg008.medium.com/last-words-on-ui-architecture-before-an-ai-takes-over-468c78f18f0d) +- [(Report) Julia Nikolaeva, iSpring - Big Ball of Mud and other problems of the monolith, we have handled](http://youtu.be/gna4Ynz1YNI) +- [(Article) DD - Big Ball of mud](https://thedomaindrivendesign.io/big-ball-of-mud/) diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/clean-architecture.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/clean-architecture.mdx index df6e03feac..05d1bcb9db 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/clean-architecture.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/clean-architecture.mdx @@ -6,4 +6,21 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Clean Architecture - \ No newline at end of file + + +## About the approach + +## About applicability in the frontend + +## Methodology position + +> How are they similar (to many), how are they different + +## See also + +- [(Thread) About use-case/interactor in the methodology](https://t.me/feature_sliced/3897) +- [(Thread) About DI in the methodology](https://t.me/feature_sliced/4592) +- [(Article) Alexander Bespalov - Clean Architecture on frontend](https://bespoyasov.ru/blog/clean-architecture-on-frontend/) +- [(Article) DDD, Hexagonal, Onion, Clean, CQRS, ... How I put it all together](https://herbertograca.com/2017/11/16/explicit-architecture-01-ddd-hexagonal-onion-clean-cqrs-how-i-put-it-all-together/) +- [(Talk) Ilya Azin - Feature Sliced (fragment about Clean Architecture, DDD)](https://youtu.be/SnzPAr_FJ7w?t=528) +- [(Article) Misconceptions of Clean Architecture](http://habr.com/ru/company/mobileup/blog/335382/) diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/ddd.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/ddd.mdx index 27ae34f2a1..d198577d20 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/ddd.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/ddd.mdx @@ -6,4 +6,17 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # DDD - \ No newline at end of file + + +## About the approach + +## Why does it work poorly in practice + +## Methodology position + +> What is the difference, how does it improve applicability, where does it adopt practices + +## See also + +- [(Article) DDD, Hexagonal, Onion, Clean, CQRS, ... How I put it all together](https://herbertograca.com/2017/11/16/explicit-architecture-01-ddd-hexagonal-onion-clean-cqrs-how-i-put-it-all-together/) +- [(Talk) Ilya Azin - Feature Sliced (fragment about Clean Architecture, DDD)](https://youtu.be/SnzPAr_FJ7w?t=528) \ No newline at end of file diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/design-principles.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/design-principles.mdx index f2305c030d..618b128004 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/design-principles.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/design-principles.mdx @@ -6,6 +6,16 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Design Principles -> SOLID, GRASP, ... + - \ No newline at end of file +## What are we talking about + +> SOLID, GRASP, KISS, YAGNI, ... - and why they don't work well together in practice + +## Methodology position + +> And how does it aggregate these practices + +## See also + +- [(Talk) Ilya Azin - Feature Sliced (fragment about Design Principles)](https://youtu.be/SnzPAr_FJ7w?t=380) diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/feature-driven.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/feature-driven.mdx index fbcf0673b9..d7e0da2251 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/feature-driven.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/feature-driven.mdx @@ -6,4 +6,17 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Feature Driven - \ No newline at end of file + + +## About the approach + +## About applicability in the frontend + +## Methodology position + +> About compatibility, historical development and comparison + +## See also + +- [(Talk) Oleg Sonin-Feature Driven Architecture](https://youtu.be/BWAeYuWFHhs) +- [Feature Driven-Short specification (from the point of view of FeatureSliced)](https://github.com/feature-sliced/documentation/tree/rc/feature-driven) \ No newline at end of file diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/frameworks.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/frameworks.mdx index 877a4cc4d7..6aaed7eb60 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/frameworks.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/frameworks.mdx @@ -6,4 +6,17 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Frameworks - \ No newline at end of file + + +## About applicability in the frontend + +> Why frameworks do not solve problems, why there is no single approach + +## Methodology position + +> Framework-agnostic, conventional-approach + +## See also + +- [(Article) About the reasons for creating the methodology (fragment about frameworks)](/docs/get-started/motivation) +- [(Thread) About the applicability of the methodology for different frameworks](https://t.me/feature_sliced/3867) diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/smart-dumb-components.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/smart-dumb-components.mdx index b17891e961..c9af1b3783 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/smart-dumb-components.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/alternatives/smart-dumb-components.mdx @@ -6,6 +6,19 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Smart & Dumb components + + + > Or "Why component-containers approach is evil?" - \ No newline at end of file +## About the approach + +## About applicability in the frontend + +## Methodology position + +> About obsolescence, about a new view from the methodology + +## See also + +- [(Article) Den Abramov-Presentation and Container Components (TLDR: deprecated)](https://medium.com/@dan_abramov/smart-and-dumb-components-7ca2f9a7c7d0) diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/cheatsheet.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/cheatsheet.mdx index cdc544c581..eda8057905 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/cheatsheet.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/cheatsheet.mdx @@ -6,6 +6,13 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Usage cheatesheet + + ## Where to place module? - \ No newline at end of file +![layers-criteria-bordered-themed-w100](/img/layers/criteria.png) + +## See also +- [(Thread) About the difference between features and entities](https://t.me/feature_sliced/3776) +- [[(Thread) About the difference between things and entities (2)](https://t.me/feature_sliced/3248) +- [(Thread) About the application of criteria for decomposition](https://t.me/feature_sliced/3833) diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/for-team.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/for-team.mdx index 18651f1999..4f132b065a 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/for-team.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/for-team.mdx @@ -10,4 +10,8 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' - Onboard newcomers - Development Guidelines ("where to search N module", etc...) -- New approach for tasks \ No newline at end of file +- New approach for tasks + +## See also +- [(Thread) The simplicity of the old approaches and the importance of mindfulness](https://t.me/feature_sliced/3360) +- [(Thread) About the convenience of searching by layers](https://t.me/feature_sliced/1918) \ No newline at end of file diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/partial-application.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/partial-application.mdx index b048f12a74..509362d351 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/partial-application.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/partial-application.mdx @@ -6,4 +6,6 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Partial Application - \ No newline at end of file + + +> How to partially apply the methodology? Does it make sense? What if I ignore it? diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/promote.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/promote.mdx index 11d8debf0c..14385ac9a4 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/promote.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/promote.mdx @@ -6,4 +6,12 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Promote in company - \ No newline at end of file + + +## Do the project and the company need a methodology? + +> About the justification of the application, Those duty + +## How can I submit a methodology to a business? + +## How to prepare and justify a plan to move to the methodology? \ No newline at end of file diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/pros-cons.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/pros-cons.mdx index c5d971bbbe..87f27d9073 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/pros-cons.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/onboard/pros-cons.mdx @@ -6,6 +6,15 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Pros & Cons + + > Profits and Costs from methodology - \ No newline at end of file +## Advantages + +> [+ Overview](/docs/get-started/overview), CodeReview, Onboarding + + +## Disadvantages + +> Mental complexity and entry threshold, Many layers, Typical problems of feature-based approaches diff --git a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/tutorial/decompose.mdx b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/tutorial/decompose.mdx index 925854baff..d7540848d6 100644 --- a/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/tutorial/decompose.mdx +++ b/website/i18n/en/docusaurus-plugin-content-docs/current/get-started/tutorial/decompose.mdx @@ -6,4 +6,31 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Decomposition of logic - \ No newline at end of file + + +## The role and meaning of decomposition + +> Problem? Costs of ignoring? How can it help? Why is it matter? Resistance to change + +## How to determine the scope of responsibility + +> Layers criteria + +![layers-criteria-bordered-themed-w100](/img/layers/criteria.png) + +## Examples + +### Tweet + +![decomposed-tweet-bordered-themed](/img/decompose-twitter.png) + +### GitHub + +![decomposed-github-bordered-themed](/img/decompose-github.jpg) + +## See also +- [(Thread) General logic for features and entities](https://t.me/feature_sliced/4262) +- [(Thread) Decomposition of swollen logic](https://t.me/feature_sliced/4210) +- [(Thread) About understanding the areas of responsibility during decomposition](https://t.me/feature_sliced/4088) +- [(Thread) Decomposition of the Product List widget](https://t.me/feature_sliced/3828) +- [(Article) Different approaches to the decomposition of logic](https://www.pluralsight.com/guides/how-to-organize-your-react-+-redux-codebase) diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/atomic-design.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/atomic-design.mdx index f307d7e5a1..64a81ed82e 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/atomic-design.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/atomic-design.mdx @@ -6,4 +6,19 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Atomic Design - \ No newline at end of file + + +## О подходе + +## О применимости в фронтенде + +## Позиция методологии + +> Про совместимость, применимость в методологии и скоуп ответственности, сопоставление слоев + +## См. также + +- [Методология Atomic Design](https://atomicdesign.bradfrost.com/table-of-contents/) +- [(Тред) Про применимость в shared/ui](https://t.me/feature_sliced/1653) +- [(Видео) Кратко о Atomic Design](https://youtu.be/Yi-A20x2dcA) +- [(Доклад) Илья Азин - Feature Sliced (фрагмент про Atomic Design)](https://youtu.be/SnzPAr_FJ7w?t=587) diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/big-ball-of-mud.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/big-ball-of-mud.mdx index aef3785bc8..fa3301a2d0 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/big-ball-of-mud.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/big-ball-of-mud.mdx @@ -6,4 +6,20 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Big Ball of Mud - \ No newline at end of file + + +## Что это + +## Почему так распространено + +## Когда это начинает приносить проблемы + +## Как быть + +> И как помогает в этом FeatureSliced + +## См. также + +- [(Статья) Oleg Isonen - Last words on UI architecture before an AI takes over](https://oleg008.medium.com/last-words-on-ui-architecture-before-an-ai-takes-over-468c78f18f0d) +- [(Доклад) Юлия Николаева, iSpring - Big Ball of Mud и другие проблемы монолита, с которыми мы справились](https://youtu.be/gna4Ynz1YNI) +- [(Статья) DDD - Big Ball of mud](https://thedomaindrivendesign.io/big-ball-of-mud/) \ No newline at end of file diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/clean-architecture.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/clean-architecture.mdx index df6e03feac..b540cfdb72 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/clean-architecture.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/clean-architecture.mdx @@ -6,4 +6,21 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Clean Architecture - \ No newline at end of file + + +## О подходе + +## О применимости в фронтенде + +## Позиция методологии + +> В чем схожи (многим), чем отличаются + +## См. также + +- [(Тред) Про use-case/interactor в методологии](https://t.me/feature_sliced/3897) +- [(Тред) Про DI в методологии](https://t.me/feature_sliced/4592) +- [(Статья) Александр Беспоясов - Чистая архитектура на фронтенде](https://bespoyasov.ru/blog/clean-architecture-on-frontend/) +- [(Статья) DDD, Hexagonal, Onion, Clean, CQRS, … How I put it all together](https://herbertograca.com/2017/11/16/explicit-architecture-01-ddd-hexagonal-onion-clean-cqrs-how-i-put-it-all-together/) +- [(Доклад) Илья Азин - Feature Sliced (фрагмент про Clean Architecture, DDD)](https://youtu.be/SnzPAr_FJ7w?t=528) +- [(Статья) Заблуждения Clean Architecture](https://habr.com/ru/company/mobileup/blog/335382/) diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/ddd.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/ddd.mdx index 27ae34f2a1..a92a9ffbac 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/ddd.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/ddd.mdx @@ -6,4 +6,17 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # DDD - \ No newline at end of file + + +## О подходе + +## Почему плохо работает на практике + +## Позиция методологии + +> В чем отличие, чем улучшает применимость, где перенимает практики + +## См. также + +- [(Статья) DDD, Hexagonal, Onion, Clean, CQRS, … How I put it all together](https://herbertograca.com/2017/11/16/explicit-architecture-01-ddd-hexagonal-onion-clean-cqrs-how-i-put-it-all-together/) +- [(Доклад) Илья Азин - Feature Sliced (фрагмент про Clean Architecture, DDD)](https://youtu.be/SnzPAr_FJ7w?t=528) \ No newline at end of file diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/design-principles.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/design-principles.mdx index a066938fc0..bebdbe9183 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/design-principles.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/design-principles.mdx @@ -6,6 +6,16 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Принципы проектирования -> SOLID, GRASP, ... + - \ No newline at end of file +## Про что речь + +> SOLID, GRASP, KISS, YAGNI, ... - и почему они плохо работают вместе на практике + +## Позиция методологии + +> И как она агрегирует эти практики + +## См. также + +- [(Доклад) Илья Азин - Feature Sliced (фрагмент про Принципы проектирования)](https://youtu.be/SnzPAr_FJ7w?t=380) diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/feature-driven.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/feature-driven.mdx index fbcf0673b9..55b3a989d7 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/feature-driven.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/feature-driven.mdx @@ -6,4 +6,17 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Feature Driven - \ No newline at end of file + + +## О подходе + +## О применимости в фронтенде + +## Позиция методологии + +> Про совместимость, историческое развитие и сравнение + +## См. также + +- [(Доклад) Oleg Isonen - Feature Driven Architecture](https://youtu.be/BWAeYuWFHhs) +- [Feature Driven - Краткая спецификация (с точки зрения FeatureSliced)](https://github.com/feature-sliced/documentation/tree/rc/feature-driven) diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/frameworks.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/frameworks.mdx index 134b08da90..cbb5d6294d 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/frameworks.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/frameworks.mdx @@ -6,4 +6,17 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Фреймворки - \ No newline at end of file + + +## О применимости в фронтенде + +> Почему фреймворки не решают проблем, почему нет едиого подхода + +## Позиция методологии + +> Framework-agnostic, conventional-подход + +## См. также + +- [(Статья) Про причины создания методологии (фрагмент про фреймворки)](/docs/get-started/motivation) +- [(Тред) Про применимость методологии для разных фреймворков](https://t.me/feature_sliced/3867) diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/smart-dumb-components.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/smart-dumb-components.mdx index a19b8f66f8..d25feac232 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/smart-dumb-components.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/alternatives/smart-dumb-components.mdx @@ -6,6 +6,18 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Тупые и умные компоненты + + > Или "Почему компонентно/контейнерный подход - зло" - \ No newline at end of file +## О подходе + +## О применимости в фронтенде + +## Позиция методологии + +> Про устарелость, про новый взгляд со стороны методологии + +## См. также + +- [(Статья) Dan Abramov - Presentational and Container Components (TLDR: deprecated)](https://medium.com/@dan_abramov/smart-and-dumb-components-7ca2f9a7c7d0) diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/cheatsheet.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/cheatsheet.mdx index f3daeacddd..5b575c2e42 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/cheatsheet.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/cheatsheet.mdx @@ -6,6 +6,13 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Памятка по использованию + + ## Куда положить модуль? - \ No newline at end of file +![layers-criteria-bordered-themed-w100](/img/layers/criteria.png) + +## См. также +- [(Тред) Про разницу между фичами и сущностями](https://t.me/feature_sliced/3776) +- [(Тред) Про разницу между фичами и сущностями (2)](https://t.me/feature_sliced/3248) +- [(Тред) Про применение критериев при декомпозиции](https://t.me/feature_sliced/3833) diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/for-team.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/for-team.mdx index 51f31d598f..f5315cf556 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/for-team.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/for-team.mdx @@ -10,4 +10,8 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' - Онбординг новых людей - Гайдлайны по разработке (где искать модули и т.п.) -- Новый подход к задачам \ No newline at end of file +- Новый подход к задачам + +## См. также +- [(Тред) Простота старых подходов и значение осознанности](https://t.me/feature_sliced/3360) +- [(Тред) Про удобство поиска по слоям](https://t.me/feature_sliced/1918) \ No newline at end of file diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/partial-application.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/partial-application.mdx index a7b5315016..c4714e1a1c 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/partial-application.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/partial-application.mdx @@ -6,4 +6,6 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Частичное применение - \ No newline at end of file + + +> Как частично применять методологию? Имеет ли смысл? Что если игнорировать? diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/promote.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/promote.mdx index f6d9ea1860..89c553780d 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/promote.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/promote.mdx @@ -6,4 +6,12 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Продвижение в компании - \ No newline at end of file + + +## Нужна ли методология проекту и компании? + +> Про оправданность применения, Техдолг + +## Как подать методологию бизнесу? + +## Как подготовить и оправдать план по переезду на методологию? diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/pros-cons.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/pros-cons.mdx index 0f962e5ea7..4c2231073c 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/pros-cons.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/onboard/pros-cons.mdx @@ -6,6 +6,13 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Плюсы и Минусы -> Профиты и Затраты от методологии + - \ No newline at end of file +## Преимущества + +> [+ Overview](/docs/get-started/overview), CodeReview, Onboarding + + +## Недостатки + +> Ментальная сложность и порог входа, Много слоев, Типичные проблемы feature-based подходов diff --git a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/tutorial/decompose.mdx b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/tutorial/decompose.mdx index 87392ec274..06e55f0d9a 100644 --- a/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/tutorial/decompose.mdx +++ b/website/i18n/ru/docusaurus-plugin-content-docs/current/get-started/tutorial/decompose.mdx @@ -6,4 +6,31 @@ import WIP from '@site/src/shared/ui/wip/tmpl.mdx' # Декомпозиция логики - \ No newline at end of file + + +## Роль и значение декомпозиции + +> Проблематика, Что будет если игнорировать, Чем может помочь, Почему это важно, Про устойчивость к изменениям + +## Как определять скоуп ответственности + +> Критерии слоев + +![layers-criteria-bordered-themed-w100](/img/layers/criteria.png) + +## Примеры + +### Tweet + +![decomposed-tweet-bordered-themed](/img/decompose-twitter.png) + +### GitHub + +![decomposed-github-bordered-themed](/img/decompose-github.jpg) + +## См. также +- [(Тред) Общая логика для фич и сущностей](https://t.me/feature_sliced/4262) +- [(Тред) Декомпозиция разбухшей логики](https://t.me/feature_sliced/4210) +- [(Тред) Про понимание зон ответственности при декомпозиции](https://t.me/feature_sliced/4088) +- [(Тред) Декомпозиция виджета ProductList](https://t.me/feature_sliced/3828) +- [(Статья) Разные подходы при декомпозиции логики](https://www.pluralsight.com/guides/how-to-organize-your-react-+-redux-codebase) diff --git a/website/src/app/index.css b/website/src/app/index.css index 559c129244..30c87b0bce 100644 --- a/website/src/app/index.css +++ b/website/src/app/index.css @@ -119,6 +119,10 @@ html img[alt*="bordered"] { border-radius: 16px; } +html img[alt*="w100"] { + width: 100%; +} + .codesandbox { width: 100%; height: 700px; diff --git a/website/static/img/decompose-github.jpg b/website/static/img/decompose-github.jpg new file mode 100644 index 0000000000..76b5f12b2e Binary files /dev/null and b/website/static/img/decompose-github.jpg differ diff --git a/website/static/img/decompose-twitter.png b/website/static/img/decompose-twitter.png new file mode 100644 index 0000000000..025906c783 Binary files /dev/null and b/website/static/img/decompose-twitter.png differ diff --git a/website/static/img/layers/criteria.png b/website/static/img/layers/criteria.png new file mode 100644 index 0000000000..a031e9f6dd Binary files /dev/null and b/website/static/img/layers/criteria.png differ