스택 사양 업데이트
업데이트할 내용: 사실(버전, 날짜, 측정값, 출처). 결정 사항은 작성자에게 제안하고 대기합니다. 인수가 주어지면 해당 도구만 확인하며, 그렇지 않으면 모두 확인합니다.
1. 목록화
stack-spec.md에서 다음을 나열합니다:
- §2의 각 행과 버전 줄
- §3 및 §4의 모든 버전, 릴리스 날짜 또는 안정성 주장("stable", "release candidate", "alpha", "experimental", 도구 옆의 버전 번호)
- 재방문 시기의 각 행 (테스트할 조건)
- 헤더의 버전 날짜
2. 각 항목을 1차 출처와 대조
레지스트리, 릴리스 노트, 공식 문서. 절대 기억에 의존하지 않음.
- npm:
npm view <pkg> dist-tags time --json. 현재 버전은 최소 14일 경과한 최신 릴리스. 그보다 최근 릴리스는 예정된 것으로 표시. - nixpkgs 도구 (Node.js, Biome, nixfmt, Wrangler, Playwright 브라우저):
nix eval --raw nixpkgs#<pkg>.version(nixos-unstable채널) 및 프로젝트 릴리스 페이지. - 플랫폼 기능 (Cloudflare, 브라우저 지원): 공식 문서 페이지와 그 날짜.
도구별 기록: 사양의 버전 줄, 현재 버전, 그리고 사양이 기다리는 주요 릴리스(또는 릴리스)가 그 사이에 있는지 여부.
3. 각 변경 사항 분류
각 신규 주요 릴리스의 체인지로그 또는 마이그레이션 가이드를 전체 읽고, 사양이 의존하는 문서도 읽습니다. 그런 다음 분류:
- 사실 (버전 줄, 날짜, 패키지 수): 업데이트.
- 이유 (명시된 단점이 해결됨, 새로운 단점 도입됨): 이유 텍스트 업데이트; 보고서에 나열.
- 결정 (선택 자체, 현재 더 나은 대안, 재방문 시기 트리거 발동): 편집하지 않음. 보고: 변경 사항, 출처, 비용이 포함된 옵션, 권장 사항. 대기.
4. 편집
- 사양 스타일 유지: 간결하게, 규칙 우선, 이유는 그 뒤에, ISO 날짜; 변경된 결정 텍스트는 "Amended : …"로 표시.
- 새로운 사실 → 번호가 매겨진 목록 끝에 새 출처 추가, "checked " 포함. 출처 번호를 다시 매기지 않음. 인용되지 않은 출처만 삭제.
- 섹션 번호를 다시 매기지 않음. 새 주제는 해당 섹션의 다음 하위 섹션이 됩니다. 사이트에서 이미 해당 번호를 사용하는지 작성자에게 문의하고 선택된 번호를 보고.
- 헤더의 버전 날짜 업데이트.
- 사양을 사용하는 사이트, 사용자 또는 저장소의 이름을 명시하지 않음.
5. 확인 및 커밋
- 모든 새 URL 또는 변경된 URL이 확인됨:
curl -sIL <url>. - 사양을 사용하는 사이트, 사용자 또는 저장소의 이름이 명시되지 않음.
- Jujutsu, 서명, 테마당 하나의 커밋 (예: "Record Astro 8", "Propose TypeScript 7"), 메시지에는 변경 사항, 이유, 확인된 출처가 명시. 요청하지 않으면 푸시하지 않음.
6. 보고
도구별: 사양의 버전 → 현재 버전. 그 다음: 업데이트된 사실, 변경된 이유, 권장 사항과 함께 제안된 결정, 14일이 지나지 않은 예정된 릴리스.