Skip to content

Commit 9b140c5

Browse files
committed
docs: update WHY docs with TanStack Form, Jotai bottom-up model, mise onboarding
1 parent 8c6adcf commit 9b140c5

2 files changed

Lines changed: 18 additions & 6 deletions

File tree

docs/WHY.ko.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -36,10 +36,16 @@
3636

3737
### Jotai
3838

39-
- **원자적 상태**: 보일러플레이트 없음, 아톰과 파생 아톰만
39+
- **바텀업 원자 모델**: 아톰을 조합해 상태를 구성하고, 아톰 의존성 기반으로 렌더링 최적화
40+
- **불필요한 리렌더 없음**: 변경된 아톰을 구독하는 컴포넌트만 리렌더
4041
- **TypeScript 우선**: 뛰어난 타입 추론
4142
- **경량**: ~3KB, 기본 사용에 프로바이더 불필요
42-
- **Suspense 지원**: React concurrent 기능과 완벽 호환
43+
44+
### TanStack Form
45+
46+
- **헤드리스 & 컴포저블**: `withForm` HOC 패턴으로 타입 안전한 모듈화된 폼 구성
47+
- **타입 안전**: 폼 값과 검증에 대한 완전한 TypeScript 추론
48+
- **심플한 인터페이스**: React Hook Form이나 Formik보다 깔끔한 API
4349

4450
## 백엔드
4551

@@ -155,7 +161,7 @@
155161
### mise
156162

157163
- **폴리글랏 모노레포 지원**: Node, Python, Flutter, Terraform — 다른 생태계를 하나의 도구로
158-
- **프로젝트 로컬 버전**: `.mise.toml`모든 런타임에서 팀 일관성 보장
164+
- **프로젝트 로컬 버전**: `.mise.toml`개발자 온보딩 시 OS 독립적으로 일관된 환경 보장
159165
- **태스크 러너**: Makefile, npm scripts, shell scripts를 통합된 `mise` 명령어로 대체
160166
- **Rust로 작성**: 즉각적인 도구 전환, 시작 오버헤드 없음
161167

docs/WHY.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -36,10 +36,16 @@ This document explains the reasoning behind each technology choice in this fulls
3636

3737
### Jotai
3838

39-
- **Atomic state**: No boilerplate, just atoms and derived atoms
39+
- **Bottom-up atomic model**: Build state by combining atoms, optimize renders based on atom dependency
40+
- **No extra re-renders**: Only components subscribed to changed atoms re-render
4041
- **TypeScript-first**: Excellent type inference
4142
- **Lightweight**: ~3KB, no providers required for basic usage
42-
- **Suspense-ready**: Works seamlessly with React concurrent features
43+
44+
### TanStack Form
45+
46+
- **Headless & composable**: `withForm` HOC pattern for modular form composition with type safety
47+
- **Type-safe**: Full TypeScript inference for form values and validation
48+
- **Simple interface**: Cleaner API compared to React Hook Form or Formik
4349

4450
## Backend
4551

@@ -155,7 +161,7 @@ We prioritize **speed** across the entire development workflow by choosing Rust-
155161
### mise
156162

157163
- **Polyglot monorepo support**: Node, Python, Flutter, Terraform — different ecosystems, one tool
158-
- **Project-local versions**: `.mise.toml` ensures team consistency across all runtimes
164+
- **Project-local versions**: `.mise.toml` ensures consistent environments across OS during developer onboarding
159165
- **Task runner**: Replace Makefile, npm scripts, shell scripts with unified `mise` commands
160166
- **Written in Rust**: Instant tool switching, no startup overhead
161167

0 commit comments

Comments
 (0)