📚 reading-open-source

오픈 소스 코드를 읽고, 이해하고, 구조적으로 기록하기 위한 개인 학습 레포지토리입니다.

✨목적

AI 시대에 개발자로서 어떤 역량이 가장 중요할지 고민하던 중,
결국 코드를 제대로 읽고 이해하는 능력이 중요하다고 생각했습니다.

이 레포지토리는 그 문제의식에서 출발해,
실제로 널리 사용되는 오픈 소스 코드를 직접 읽으며

• 코드의 구조와 역할을 파악하고
• 설계 의도를 설명해보고
• 직접 사용하며 동작을 검증하는

과정을 기록하는 공간입니다.

단순히 새로 접한 문법·패턴·표현을 나열하는 데 그치지 않고,
“왜 이런 구조와 구현을 선택했는가” 를 이해하는 데 초점을 두고 있습니다.

🧠 학습 방식

각 오픈 소스는 아래와 같은 동일한 구조로 분석합니다.

1. 소스 코드 직접 읽기 → entry point부터 내부 구현까지 흐름을 따라가며 분석

2. 문서화 → 파일 단위 / 타입 단위로 역할, 의도, 연결 관계를 정리

3. 확인 → 문서를 작성하며 떠오른 의문을 바로 코드로 확인해보기 위한 공간

📂 폴더 구조

reading-open-source/
├─ shadcn-ui/
│  ├─ src/          # 분석 대상 오픈 소스 코드
│  ├─ docs/         # 코드 분석 및 정리 문서 (md)
│  └─ playground/   # Vite + React 기반 실험 공간
│
├─ zustand/
│  ├─ src/          
│  ├─ docs/        
│  └─ playground/   
│
│   ...
│
└─ README.md

디렉터리 설명

• src/
  실제 오픈 소스의 코드를 수정하지 않고 그대로 두어, 읽고 분석하는 용도로 사용합니다.

• docs/
  src 내부 코드를 읽으며 정리한 분석 문서입니다. 구조, 책임 분리, 설계 의도 등을 중심으로 기록합니다.

• playground/
  Vite + React 환경에서 해당 라이브러리를 직접 사용하며, 문서에서 이해한 내용을 코드로 검증하고 확인합니다.

🎯 이 레포지토리를 통해 얻고 싶은 것

• 처음 보는 코드라도 두려워하지 않고 읽을 수 있는 힘
• 타입과 구조만 보고도 설계 의도를 추론하는 능력
• AI 도구와 함께 일하되, 코드의 최종 판단은 스스로 할 수 있는 개발자 역량

📝 기타

• 이 레포지토리는 학습 기록용이며, 지속적으로 업데이트됩니다.
• 문서 내용은 개인적인 이해를 바탕으로 작성되었으며, 공식 문서와 다를 수 있습니다.