Skip to content

Commit 82c99c3

Browse files
authored
docs: Improve FAQ readability in Korean documentation (#876)
1 parent dce489e commit 82c99c3

File tree

1 file changed

+31
-32
lines changed
  • i18n/kr/docusaurus-plugin-content-docs/current/get-started

1 file changed

+31
-32
lines changed

i18n/kr/docusaurus-plugin-content-docs/current/get-started/faq.md

Lines changed: 31 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)