Skip to content

Commit 51c2525

Browse files
authored
docs: cleanup and reorganize ko/current/about for better readability (#885)
1 parent 298e812 commit 51c2525

6 files changed

Lines changed: 329 additions & 220 deletions

File tree

i18n/kr/docusaurus-plugin-content-docs/current/about/mission.md

Lines changed: 32 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -4,47 +4,60 @@ sidebar_position: 1
44

55
# Mission
66

7-
이 문서는 우리가 방법론을 개발할 때 따르는 **목표와 적용 가능성의 한계**를 설명합니다.
7+
이 문서는 우리가 이 방법론을 설계할 때 어떤 **목표**를 가지고 있는지,
8+
그리고 실제로 적용할 때 어떤 **한계**가 있는지를 설명합니다.
89

9-
- 방법론의 목표는 **이념과 단순성의 균형**을 맞추는 것입니다.
10-
- 모든 사람에게 완벽하게 들어맞는 만능 해결책은 존재하지 않습니다.
10+
방법론의 목표는 **이념적 완벽함과 실용적인 단순성 사이의 균형**을 맞추는 것입니다.
11+
모든 사람과 모든 프로젝트에 100% 들어맞는 만능 해결책은 존재하지 않습니다.
1112

12-
**그럼에도, 방법론은 다양한 개발자들이 쉽게 접근할 수 있고 실용적이어야 합니다.**
13+
그럼에도 불구하고, 이 방법론은 **다양한 개발자들이 쉽게 접근할 수 있고, 실제 업무에서 충분히 쓸 만해야 합니다.**
1314

1415
## 목표
1516

1617
### 다양한 개발자에게 직관적이고 명확하게
1718

18-
방법론은 프로젝트에 참여하는 대부분의 팀원들이 쉽게 접근하고 이해할 수 있도록 설계되어야 합니다.
19+
방법론은 프로젝트에 참여하는 **대부분의 팀원들이 쉽게 이해하고 사용할 수 있도록** 설계되어야 합니다.
1920

20-
*향후 새로운 도구가 추가되더라도, 시니어나 리더급 개발자만 이해할 수 있다면 그 방법론은 충분하지 않습니다.*
21+
_새로운 도구나 개념이 추가되었을 때, 시니어나 리더급 개발자만 이해할 수 있다면 그 방법론은 충분하지 않습니다._
2122

2223
### 일상적인 문제 해결
2324

24-
방법론은 개발 프로젝트에서 자주 발생하는 문제에 대해 **명확한 근거와 해결책**을 제시해야 합니다.
25+
방법론은 실제 개발 과정에서 자주 맞닥뜨리는 문제들에 대해
26+
**명확한 기준과 해결책**을 제시해야 합니다.
2527

26-
**이를 위해 CLI, 린터(linter) 같은 도구들도 함께 제공해야 합니다.**
28+
이를 위해 **CLI, 린터(linter)** 같은 도구도 함께 제공하는 것이 중요합니다.
2729

28-
이를 통해 개발자들은 아키텍처 및 개발 과정에서 발생하는 반복적인 문제를 피하고, 검증된 접근 방식을 활용할 수 있습니다.
30+
이런 도구들을 통해 개발자들은
2931

30-
> *@sergeysova: 방법론을 기반으로 코드를 작성하는 개발자는 이미 많은 문제에 대한 해법을 내장한 채로 시작하기 때문에, 문제 발생 빈도가 10배 정도 줄어들 것이라고 상상해보세요.*
32+
- 아키텍처 설계나 구현 과정에서 반복적으로 발생하는 문제를 줄이고,
33+
- 이미 검증된 접근 방식을 자연스럽게 사용할 수 있습니다.
34+
35+
> _@sergeysova: 방법론을 기반으로 코드를 작성하는 개발자는
36+
> 이미 많은 문제에 대한 “해법 세트”를 가지고 시작한다고 상상해 보세요.
37+
> 문제 발생 빈도가 10배 정도 줄어든다고 생각할 수 있습니다._
3138
3239
## 한계
3340

34-
우리는 *특정 관점을 강요하지 않으며*, 동시에 *개발자로서의 습관이 문제 해결을 방해할 수 있다는 점*도 이해합니다.
41+
우리는 _특정 관점을 강요하지 않으려_ 하면서도,
42+
동시에 *개발자로서 기존 습관이 오히려 문제 해결을 방해할 수 있다는 점*도 인지하고 있습니다.
3543

36-
개발자마다 시스템 설계, 개발 경험 수준이 다르기 때문에, **다음 사항을 이해하는 것이 중요합니다:**
44+
개발자마다 시스템 설계 경험과 개발 경력이 다르기 때문에,
45+
아래 내용을 이해하는 것이 중요합니다.
3746

3847
- **항상 통하지는 않음**
39-
너무 단순하고 명확한 접근이 모든 상황과 모든 사람에게 항상 효과적인 것은 아닙니다.
40-
> *@sergeysova: 일부 개념은 직접 문제를 겪고, 오랜 시간 고민하며 해결하는 과정을 거쳐야만 직관적으로 이해할 수 있습니다.*
41-
>
42-
> - *수학: 그래프 이론*
43-
> - *물리학: 양자 역학*
44-
> - *프로그래밍: 애플리케이션 아키텍처*
48+
단순하고 명확한 접근법이라고 해서
49+
모든 상황, 모든 사람에게 항상 효과적이라고 볼 수는 없습니다.
50+
51+
> _@sergeysova: 어떤 개념은 직접 문제를 겪고,
52+
> 오랜 시간 고민하며 해결해 보는 과정을 거쳐야만
53+
> 비로소 직관적으로 이해할 수 있습니다._
54+
>
55+
> - _수학: 그래프 이론_
56+
> - _물리학: 양자 역학_
57+
> - _프로그래밍: 애플리케이션 아키텍처_
4558
4659
- **가능하고 바람직한 방향**
47-
단순함, 확장 가능성
60+
이 방법론은 **단순함****확장 가능성**을 지향하는 방향으로 설계되었습니다.
4861

4962
## 참고 자료
5063

0 commit comments

Comments
 (0)