공식 문서 마이그레이션 상태
원본 사이트: https://docs.tangly1024.com
목표: docs/user-guide/
상태: 구버전 사이트 내비게이션의 104개 페이지가 모두 로컬 Markdown으로 이전되었습니다. 본문, 이미지 링크, 원문 URL, 기본 메타데이터는 docs.tangly1024.com의 NotionNext 페이지 데이터에서 가져왔습니다. 대응표: ARTICLE_INDEX.md.
이전 완료(섹션별)
| 섹션 | 로컬 디렉터리 |
|---|---|
| 입문 / 배포 입문 | 루트 intro.md, deploy-vercel.md 등 |
| 설치와 배포 | deploy/ |
| 사이트 설정 | config/, config-site.md |
| Notion 가이드 | notion/, notion-database.md |
| 메뉴 | menu-secondary.md |
| 변경 로그 | changelog/, UPDATE.md(GitHub) |
| 테마 | themes/(THEMES_CATALOG.md 포함); 개발 상세 문서 docs/developer/themes(GitHub) |
| 사이트 통계 | analytics/ |
| 댓글 플러그인 | comments/ |
| 외부 확장 | plugins/ |
| 개발 가이드 | development/ + docs/developer/GETTING_STARTED.md 등 |
| 운영 | operations/ |
| 도움말 / 지원 | help/ |
콘텐츠 갱신(4.9.x, 저장소 전용)
| 문서 | 역할 |
|---|---|
| reference/features.md | conf/*.config.js와 맞춘 전체 사이트 설정 |
| reference/notion-4x.md | 최근 Notion / 사이트 기능 |
| themes/THEMES_CATALOG.md | 25개 테마 설명과 설정 접두사 |
| changelog/latest.md | 4.9.5.x 요점(v4.0 전문 복사 아님) |
유지보수 시: 기능 수정 → 먼저 conf/ 수정 → reference/features.md와 관련 user-guide 문서 수정.
특수 처리
| 원문 | 처리 방식 |
|---|---|
v4.0 초장문 changelog | changelog/v4-history.md 색인 + GitHub Releases |
latest | changelog/latest.md |
example-1 | notion/example-article.md + 구버전 원문 |
notion-tutorial | 유료 강의 외부 링크 |
vercel-accelerate, vercel-redploy | deploy/vercel-accelerate.md, deploy/vercel-redeploy.md |
구버전 사이트 입구와 댓글
- 사용자용 내비게이션: help/legacy-docs.md(slug 대응표 + 구버전 사이트 바로가기)
- 문서 사이트 하단: Giscus →
notionnext-org/NotionNextDiscussions(maintain-docs.md 참고) - 유지보수자 일괄 가져오기:
node scripts/import-legacy-docs.mjs
유지보수
- 가이드 수정 →
docs/user-guide/**편집 후 ARTICLE_INDEX.md 갱신 - 정책 설명 → ../DOCUMENTATION_POLICY.md
- 단계 체크리스트 → MAINTENANCE_WORKFLOW.md