왜 Moonworld Docs인가
GitHub 저장소 목록만으로는 프로젝트의 목적과 구현 의도가 충분히 드러나지 않습니다. Moonworld Docs는 그 빈칸을 문서로 채우기 위해 만들었습니다.
핵심 원칙
- 저장소보다 설명을 우선합니다.
- 기능 목록보다 문제 정의와 판단 근거를 남깁니다.
- 배포와 운영 경험도 프로젝트 문서의 일부로 취급합니다.
이 구조를 택한 이유
일반적인 포트폴리오 사이트는 보기에는 좋지만, 구현 맥락을 압축하는 데 그치는 경우가 많습니다. 반대로 문서 사이트는 설명력은 좋지만 첫 진입이 딱딱해지기 쉽습니다. 그래서 홈은 간결하게, Guide는 입문형으로, Projects는 케이스 스터디형으로 분리했습니다.
NOTE
이 사이트는 "소개 페이지"보다 "읽을 수 있는 작업 기록"에 더 가깝습니다.
어떤 프로젝트가 올라와야 하나
- 문제 정의가 분명한 프로젝트
- 기술 선택 이유를 설명할 수 있는 프로젝트
- 배포 또는 운영 경험이 남아 있는 프로젝트
- 나중에 다시 읽어도 가치가 있는 프로젝트
다음 단계
실제 공개 가능한 프로젝트를 이 기준으로 선별해 Projects 섹션의 대표 문서로 올리는 것이 다음 목표입니다.