@@ -11,57 +11,56 @@ pagination_next: guides/examples/auth
1111
1212### Toolkit이나 Linter가 있나요?
1313
14- 프로젝트 아키텍처를 FSD 규칙에 맞게 검사 [ Steiger] [ ext-steiger ] Linter가 있으며, CLI · IDE 확장을 통해 사용할 수 있는 [ 폴더 생성기] [ ext-tools ] 도 함께 제공됩니다.
14+ 프로젝트 구조가 FSD 규칙에 맞는지 점검하는 ** [ Steiger Linter] [ ext-steiger ] ** 가 있습니다.
15+ 또한 CLI나 IDE 확장을 통해 사용할 수 있는 ** [ FSD 구조 생성 도구] [ ext-tools ] ** 도 제공합니다.
1516
16- ### Page Layout / Template은 어디에 보관해야 하나요?
17+ ### Page Layout / Template은 어디에 보관해야 하나요?
1718
18- - ** 단순 마크업 ** 이라면 ` shared/ui ` 에 두는 것이 일반적입니다.
19- - 코드가 몇 줄뿐이라면 굳이 추상화하지 말고 각 페이지에 직접 작성해도 무방합니다.
20- - 복잡한 Layout이 필요하다면 별도 ** Widget** 또는 ** Page** 로 분리하고 App Router(또는 Nested Routing)에서 조합하세요.
19+ 단순한 마크업이라면 ` shared/ui ` 에 두는 것이 일반적입니다.
20+ 레이아웃이 간단하다면 ** 별도 추상화 없이 각 페이지에 직접 작성해도 됩니다. **
21+ 복잡한 구조라면 별도 ** Widget** 이나 ** Page** 로 분리해 App Router(Nested Routing 포함 )에서 조합하세요.
2122
2223### Feature와 Entity의 차이는 무엇인가요?
23-
2424| 구분 | 정의 | 예시 |
2525| --- | --- | --- |
2626| ** Entity** | 애플리케이션이 다루는 ** 비즈니스 개체** | ` user ` , ` product ` |
27- | ** Feature** | 사용자가 Entity로 수행하는 ** 실제 상호작용** | 로그인, 장바구니 담기 |
27+ | ** Feature** | 사용자가 Entity로 수행하는 ** 상호작용** | 로그인, 장바구니 담기 |
2828
29- 더 자세한 내용과 예시는 [ Slices] [ reference-entities ] 에서 확인할 수 있습니다.
29+ 더 자세한 설명과 코드 예시는 [ Slices] [ reference-entities ] 문서에서 확인할 수 있습니다.
3030
3131### Pages, Features, Entities를 서로 포함할 수 있나요?
32-
3332가능합니다. 다만 ** 상위 Layer** 에서만 조합해야 합니다.
34- 예: Widget 내부에서 여러 Feature를 props / children 형태로 결합할 수 있지만, 한 Feature가 다른 Feature를 직접 import 하는 것은 [ ** Layer Import 규칙** ] [ import-rule-layers ] 에 의해 금지됩니다.
33+ 예를 들어, Widget 내부에서는 여러 Feature를 ** props** 나 ** children** 형태로 조합할 수 있습니다.
34+ 하지만 한 Feature가 다른 Feature를 직접 import 하는 것은 [ ** Layer Import 규칙** ] [ import-rule-layers ] 에 따라 금지됩니다.
3535
3636### Atomic Design을 함께 사용할 수 있나요?
3737
38- 네. FSD는 Atomic Design 사용을 ** 요구하지도, 금지하지도** 않습니다.
39- 필요하다면 ` ui ` Segment 내부에서 Atomic 분류를 적용할 수 있습니다. [ 예시] ( https://t.me/feature_sliced/1653 )
38+ 궁금하다면 [ 예시] ( https://t.me/feature_sliced/1653 ) 를 참고하세요.
39+ FSD는 Atomic Design 사용을 ** 제한하지 않습니다.**
40+ 필요하다면 ` ui ` Segment 안에서 Atomic 분류를 적용할 수 있습니다.
4041
4142### FSD 관련 참고 자료가 더 있나요?
43+ 더 다양한 예제와 자료는 [ feature-sliced/awesome] ( https://github.com/feature-sliced/awesome ) 에서 확인할 수 있습니다.
4244
43- 커뮤니티가 정리한 자료 모음은 [ feature‑sliced/awesome] ( https://github.com/feature-sliced/awesome ) 에서 확인할 수 있습니다.
44-
45- ### Feature‑Sliced Design이 필요한 이유는 무엇인가요?
46-
47- 표준화된 아키텍처는 프로젝트를 빠르게 파악하게 해 줍니다.
48- 온보딩 속도를 높이고 “폴더 구조 논쟁”을 줄여 주는 것이 FSD의 핵심 가치입니다. 자세한 배경은 [ Motivation] [ motivation ] 페이지를 참고하세요.
45+ ### Feature-Sliced Design이 필요한 이유는 무엇인가요?
46+ FSD는 프로젝트를 ** 핵심 기능 단위로 명확하게 구조화** 할 수 있도록 돕습니다.
47+ 표준화된 구조는 온보딩 속도를 높이고, 폴더 구조에 대한 불필요한 논쟁을 줄여 줍니다.
48+ 자세한 배경은 [ Motivation] [ motivation ] 페이지를 참고하세요.
4949
5050### 주니어 개발자도 아키텍처 방법론이 필요할까요?
5151
52- 필요합니다.
53- * 혼자 개발할 때는 문제가 없어 보여도, 개발 공백이 생기거나 새로운 팀원이 합류하면 구조의 중요성이 드러납니다*
54-
52+ 필요합니다. 혼자 개발할 때는 구조의 중요성이 잘 느껴지지 않지만,
53+ 새로운 팀원이 합류하거나 개발이 일시적으로 중단되더라도, ** 명확한 구조 덕분에 프로젝트를 쉽게 이어갈 수 있습니다.**
5554
5655### 인증(Auth) Context는 어떻게 다루나요?
57-
58- [ 예제 가이드] ( /docs/guides/examples/auth ) 에서 자세히 설명했습니다 .
59-
60- [ ext-steiger ] : https://github.com/feature-sliced/steiger
61- [ ext-tools ] : https://github.com/feature-sliced/awesome?tab=readme-ov-file#tools
62- [ import-rule-layers ] : /docs/reference/layers#import-rule-on-layers
63- [ reference-entities ] : /docs/reference/layers#entities
64- [ motivation ] : /docs/about/motivation
65- [ telegram ] : https://t.me/feature_sliced
66- [ discord ] : https://discord.gg/S8MzWTUsmp
67- [ github-discussions ] : https://github.com/feature-sliced/documentation/discussions
56+
57+ 관련 예시는 [ Auth 예제 가이드] ( /docs/guides/examples/auth ) 에서 확인할 수 있습니다 .
58+
59+ [ ext-steiger] : https://github.com/feature-sliced/steiger
60+ [ ext-tools] : https://github.com/feature-sliced/awesome?tab=readme-ov-file#tools
61+ [ import-rule-layers] : /docs/reference/layers#import-rule-on-layers
62+ [ reference-entities] : /docs/reference/layers#entities
63+ [ motivation] : /docs/about/motivation
64+ [ telegram] : https://t.me/feature_sliced
65+ [ discord] : https://discord.gg/S8MzWTUsmp
66+ [ github-discussions ] : https://github.com/feature-sliced/documentation/discussions
0 commit comments