공식 문서는 검색, 버전 확인, 예제 실행, 관련 링크 추적으로 읽는다
문서를 읽었다는 것은 페이지를 본 것이 아니라 현재 프로젝트 조건에 맞는 적용 기준을 확인했다는 뜻이다.
| 활용 방법 | 확인할 것 | 좋은 결과 | 흔한 실수 |
|---|---|---|---|
| 검색 기능 | 오류 메시지, API 이름, 개념 키워드 | 관련 문서와 에러 설명을 바로 찾음 | 블로그 검색 결과만 먼저 봄 |
| 목차 탐색 | 현재 페이지의 전제와 하위 주제 | 기능의 위치와 관련 옵션을 함께 이해 | 필요한 코드 조각만 복사 |
| 버전 확인 | Next.js 버전, App/Pages Router 차이 | 현재 프로젝트와 같은 조건의 설명 사용 | 오래된 Pages Router 예제를 최신처럼 적용 |
| 예제 실행 | 입력, 출력, 설정 파일, 배포 조건 | 작은 코드로 동작을 검증 | 프로젝트에 바로 붙여 회귀를 만듦 |
| 관련 링크 | 심화 문서, API reference, migration | 한 기능의 주변 제약까지 파악 | 첫 문서만 보고 결론 확정 |