Skip to content

Commit a9024ff

Browse files
authored
docs: translate code smells documentation pages into korean (#767)
* docs: code smells cross-imports page translated into Korean * docs: code smells desegmented page translated into Korean * docs: code smells routes page translated into Korean * docs: code small page feedback
1 parent 806a777 commit a9024ff

File tree

4 files changed

+166
-0
lines changed

4 files changed

+166
-0
lines changed
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
label: Code smells & Issues
2+
position: 4
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
---
2+
sidebar_position: 4
3+
sidebar_class_name: sidebar-item--wip
4+
pagination_next: reference/index
5+
---
6+
7+
import WIP from '@site/src/shared/ui/wip/tmpl.mdx'
8+
9+
# ํฌ๋กœ์Šค ์ž„ํฌํŠธ
10+
11+
<WIP ticket="220" />
12+
13+
> Cross-import๋Š” Layer๋‚˜ ์ถ”์ƒํ™”๊ฐ€ ์›๋ž˜์˜ ์ฑ…์ž„ ๋ฒ”์œ„๋ฅผ ๋„˜์–ด์„ค ๋•Œ ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค. ๋ฐฉ๋ฒ•๋ก ์—์„œ๋Š” ์ด๋Ÿฌํ•œ Cross-import๋ฅผ ํ•ด๊ฒฐํ•˜๊ธฐ ์œ„ํ•œ ๋ณ„๋„์˜ Layer๋ฅผ ์ •์˜ํ•ฉ๋‹ˆ๋‹ค.
14+
15+
## ์ฐธ๊ณ  ์ž๋ฃŒ
16+
17+
- [(์Šค๋ ˆ๋“œ) Cross-import๊ฐ€ ๋ถˆ๊ฐ€ํ”ผํ•œ ์ƒํ™ฉ ๋…ผ์˜](https://t.me/feature_sliced/4515)
18+
- [(์Šค๋ ˆ๋“œ) Entity์—์„œ Cross-import ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•](https://t.me/feature_sliced/3678)
19+
- [(์Šค๋ ˆ๋“œ) Cross-import์™€ ์ฑ…์ž„ ๋ฒ”์œ„ ๊ด€๊ณ„](https://t.me/feature_sliced/3287)
20+
- [(์Šค๋ ˆ๋“œ) Segment ๊ฐ„ import ์ด์Šˆ ํ•ด๊ฒฐ](https://t.me/feature_sliced/4021)
21+
- [(์Šค๋ ˆ๋“œ) Shared ๋‚ด๋ถ€ ๊ตฌ์กฐ์˜ Cross-import ํ•ด๊ฒฐ](https://t.me/feature_sliced/3618)
Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
---
2+
sidebar_position: 2
3+
sidebar_class_name: sidebar-item--wip
4+
---
5+
6+
import WIP from '@site/src/shared/ui/wip/tmpl.mdx'
7+
8+
# Desegmentation
9+
10+
<WIP ticket="148" />
11+
12+
## ์ƒํ™ฉ
13+
14+
ํ”„๋กœ์ ํŠธ์—์„œ ๋™์ผํ•œ ๋„๋ฉ”์ธ์˜ ๋ชจ๋“ˆ๋“ค์ด ์„œ๋กœ ์—ฐ๊ด€๋˜์–ด ์žˆ์Œ์—๋„ ๋ถˆ๊ตฌํ•˜๊ณ , ํ”„๋กœ์ ํŠธ ์ „์ฒด์— ๋ถˆํ•„์š”ํ•˜๊ฒŒ ๋ถ„์‚ฐ๋˜์–ด ์žˆ๋Š” ๊ฒฝ์šฐ๊ฐ€ ๋งŽ์Šต๋‹ˆ๋‹ค.
15+
16+
```sh
17+
โ”œโ”€โ”€ components/
18+
| โ”œโ”€โ”€ DeliveryCard
19+
| โ”œโ”€โ”€ DeliveryChoice
20+
| โ”œโ”€โ”€ RegionSelect
21+
| โ”œโ”€โ”€ UserAvatar
22+
โ”œโ”€โ”€ actions/
23+
| โ”œโ”€โ”€ delivery.js
24+
| โ”œโ”€โ”€ region.js
25+
| โ”œโ”€โ”€ user.js
26+
โ”œโ”€โ”€ epics/
27+
| โ”œโ”€โ”€ delivery.js
28+
| โ”œโ”€โ”€ region.js
29+
| โ”œโ”€โ”€ user.js
30+
โ”œโ”€โ”€ constants/
31+
| โ”œโ”€โ”€ delivery.js
32+
| โ”œโ”€โ”€ region.js
33+
| โ”œโ”€โ”€ user.js
34+
โ”œโ”€โ”€ helpers/
35+
| โ”œโ”€โ”€ delivery.js
36+
| โ”œโ”€โ”€ region.js
37+
| โ”œโ”€โ”€ user.js
38+
โ”œโ”€โ”€ entities/
39+
| โ”œโ”€โ”€ delivery/
40+
| | โ”œโ”€โ”€ getters.js
41+
| | โ”œโ”€โ”€ selectors.js
42+
| โ”œโ”€โ”€ region/
43+
| โ”œโ”€โ”€ user/
44+
```
45+
46+
## ๋ฌธ์ œ์ 
47+
48+
์ด๋Š” ๋†’์€ ์‘์ง‘๋„ ์›์น™์„ ์œ„๋ฐ˜ํ•˜๋ฉฐ, **Changes Axis์˜ ๊ณผ๋„ํ•œ ํ™•์žฅ**์„ ์ดˆ๋ž˜ํ•ฉ๋‹ˆ๋‹ค.
49+
50+
## ๋ฌด์‹œํ–ˆ์„ ๋•Œ์˜ ๊ฒฐ๊ณผ
51+
52+
- delivery ๊ด€๋ จ ๋กœ์ง ์ˆ˜์ • ์‹œ ์—ฌ๋Ÿฌ ์œ„์น˜์˜ ์ฝ”๋“œ๋ฅผ ์ฐพ์•„ ์ˆ˜์ •ํ•ด์•ผ ํ•˜๋ฉฐ, ์ด๋Š” **Changes Axis๋ฅผ ๋ถˆํ•„์š”ํ•˜๊ฒŒ ํ™•์žฅ**ํ•ฉ๋‹ˆ๋‹ค
53+
- user ๊ด€๋ จ ๋กœ์ง์„ ์ดํ•ดํ•˜๋ ค๋ฉด ํ”„๋กœ์ ํŠธ ์ „๋ฐ˜์˜ **actions, epics, constants, entities, components**๋ฅผ ๋ชจ๋‘ ์ฐพ์•„๋ด์•ผ ํ•ฉ๋‹ˆ๋‹ค
54+
- ์•”๋ฌต์  ์—ฐ๊ฒฐ๋กœ ์ธํ•ด ๋„๋ฉ”์ธ ์˜์—ญ์ด ๋น„๋Œ€ํ•ด์ง€๊ณ  ๊ด€๋ฆฌ๊ฐ€ ์–ด๋ ค์›Œ์ง‘๋‹ˆ๋‹ค
55+
- ๋ถˆํ•„์š”ํ•œ ํŒŒ์ผ๋“ค์ด ์Œ“์—ฌ ๋ฌธ์ œ ์ธ์‹์ด ์–ด๋ ค์›Œ์ง‘๋‹ˆ๋‹ค
56+
57+
## ํ•ด๊ฒฐ ๋ฐฉ์•ˆ
58+
59+
๋„๋ฉ”์ธ์ด๋‚˜ use case์™€ ๊ด€๋ จ๋œ ๋ชจ๋“ˆ๋“ค์„ ํ•œ ๊ณณ์— ๋ชจ์•„ ๋ฐฐ์น˜ํ•ฉ๋‹ˆ๋‹ค.
60+
61+
์ด๋ฅผ ํ†ตํ•ด ๋ชจ๋“ˆ ํ•™์Šต์ด๋‚˜ ์ˆ˜์ • ์‹œ ํ•„์š”ํ•œ ๋ชจ๋“  ์š”์†Œ๋ฅผ ์‰ฝ๊ฒŒ ์ฐพ์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
62+
63+
> ์ด ์ ‘๊ทผ์€ ์ฝ”๋“œ๋ฒ ์ด์Šค์˜ ํƒ์ƒ‰์„ฑ๊ณผ ๊ฐ€๋…์„ฑ์„ ๋†’์ด๊ณ , ๋ชจ๋“ˆ ๊ฐ„ ๊ด€๊ณ„๋ฅผ ๋” ๋ช…ํ™•ํ•˜๊ฒŒ ๋ณด์—ฌ์ค๋‹ˆ๋‹ค.
64+
65+
```diff
66+
- โ”œโ”€โ”€ components/
67+
- | โ”œโ”€โ”€ DeliveryCard
68+
- | โ”œโ”€โ”€ DeliveryChoice
69+
- | โ”œโ”€โ”€ RegionSelect
70+
- | โ”œโ”€โ”€ UserAvatar
71+
- โ”œโ”€โ”€ actions/
72+
- | โ”œโ”€โ”€ delivery.js
73+
- | โ”œโ”€โ”€ region.js
74+
- | โ”œโ”€โ”€ user.js
75+
- โ”œโ”€โ”€ epics/{...}
76+
- โ”œโ”€โ”€ constants/{...}
77+
- โ”œโ”€โ”€ helpers/{...}
78+
โ”œโ”€โ”€ entities/
79+
| โ”œโ”€โ”€ delivery/
80+
+ | | โ”œโ”€โ”€ ui/ # ~ components/
81+
+ | | | โ”œโ”€โ”€ card.js
82+
+ | | | โ”œโ”€โ”€ choice.js
83+
+ | | โ”œโ”€โ”€ model/
84+
+ | | | โ”œโ”€โ”€ actions.js
85+
+ | | | โ”œโ”€โ”€ constants.js
86+
+ | | | โ”œโ”€โ”€ epics.js
87+
+ | | | โ”œโ”€โ”€ getters.js
88+
+ | | | โ”œโ”€โ”€ selectors.js
89+
+ | | โ”œโ”€โ”€ lib/ # ~ helpers
90+
| โ”œโ”€โ”€ region/
91+
| โ”œโ”€โ”€ user/
92+
```
93+
94+
## ์ฐธ๊ณ  ์ž๋ฃŒ
95+
96+
* [(์•„ํ‹ฐํด) Coupling๊ณผ Cohesion์˜ ๋ช…ํ™•ํ•œ ์ดํ•ด](https://enterprisecraftsmanship.com/posts/cohesion-coupling-difference/)
97+
* [(์•„ํ‹ฐํด) Coupling, Cohesion๊ณผ Law of Demeter](https://medium.com/german-gorelkin/low-coupling-high-cohesion-d36369fb1be9)
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
sidebar_position: 3
3+
sidebar_class_name: sidebar-item--wip
4+
sidebar_label: Routing
5+
---
6+
7+
import WIP from '@site/src/shared/ui/wip/tmpl.mdx'
8+
9+
# Routing
10+
11+
<WIP ticket="169" />
12+
13+
## ์ƒํ™ฉ
14+
15+
Page์˜ URL์ด ํ•˜์œ„ Layer์— ํ•˜๋“œ์ฝ”๋”ฉ๋˜์–ด ์žˆ๋Š” ๊ฒฝ์šฐ๊ฐ€ ์žˆ์Šต๋‹ˆ๋‹ค.
16+
17+
```tsx title="entities/post/card"
18+
<Card>
19+
<Card.Title
20+
href={`/post/${data.id}`}
21+
title={data.name}
22+
/>
23+
...
24+
</Card>
25+
```
26+
27+
## ๋ฌธ์ œ์ 
28+
29+
URL์ด Page Layer์— ์ง‘์ค‘๋˜์ง€ ์•Š๊ณ , ํ•˜์œ„ Layer์— ๋ถ„์‚ฐ๋˜์–ด ๊ด€๋ฆฌ๋ฉ๋‹ˆ๋‹ค.
30+
31+
## ๋ฌด์‹œํ–ˆ์„ ๋•Œ์˜ ๊ฒฐ๊ณผ
32+
33+
URL ๋ณ€๊ฒฝ ์‹œ Page Layer ์™ธ์˜ ์—ฌ๋Ÿฌ ํ•˜์œ„ Layer์— ์žˆ๋Š” URL๊ณผ redirect ๋กœ์ง์„ ๋ชจ๋‘ ๊ณ ๋ คํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
34+
35+
๊ฒฐ๊ณผ์ ์œผ๋กœ ๋‹จ์ˆœํ•œ Product Card ๊ฐ™์€ Component๋„ Page์˜ ์ฑ…์ž„์„ ๊ฐ€์ง€๊ฒŒ ๋˜์–ด, ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ๊ฐ€ ๋ถˆํ•„์š”ํ•˜๊ฒŒ ๋ณต์žกํ•ด์ง‘๋‹ˆ๋‹ค.
36+
37+
## ํ•ด๊ฒฐ ๋ฐฉ์•ˆ
38+
39+
URL๊ณผ redirect ๋กœ์ง์€ Page Layer์™€ ๊ทธ ์ƒ์œ„ Layer์—์„œ๋งŒ ๋‹ค๋ฃจ๋„๋ก ํ•ฉ๋‹ˆ๋‹ค.
40+
41+
์ด๋ฅผ ์œ„ํ•ด composition, props ์ „๋‹ฌ, Factory ํŒจํ„ด ๋“ฑ์„ ํ™œ์šฉํ•ด URL ์ •๋ณด๋ฅผ ํ•˜์œ„ Layer์— ์ „๋‹ฌํ•ฉ๋‹ˆ๋‹ค.
42+
43+
## ์ฐธ๊ณ  ์ž๋ฃŒ
44+
45+
- [(์Šค๋ ˆ๋“œ) Entity/Feature/Widget์—์„œ Routing ์ฒ˜๋ฆฌ์˜ ์˜ํ–ฅ](https://t.me/feature_sliced/4389)
46+
- [(์Šค๋ ˆ๋“œ) Page์—์„œ๋งŒ Route ๋กœ์ง์„ ๋‹ค๋ค„์•ผ ํ•˜๋Š” ์ด์œ ](https://t.me/feature_sliced/3756)

0 commit comments

Comments
ย (0)