Release Parity Artifacts
Checklist artefak untuk memastikan parity antara source of truth, hasil build docs, dan deployment di Cloudflare Pages.
Tujuan parity
Parity = isi dokumentasi, metadata, dan URL publik mencerminkan kondisi repo terbaru tanpa konten domain lama.
Artifact matrix
| Artifact | Lokasi | Owner | Fungsi verifikasi |
|---|---|---|---|
| Source docs markdown | docs-site/docusaurus/docs/*.md | Docs owner | sumber konten utama |
| Sidebar map | docs-site/docusaurus/sidebars.js | Docs owner | memastikan navigasi lengkap |
| Docusaurus config | docs-site/docusaurus/docusaurus.config.js | Docs owner | base URL, branding, i18n |
| Build output | docs-site/docusaurus/build/ | CI/local build | bukti render statis |
| Deployed Pages URL | https://example2-doc.sudharmika.com | Deploy owner | bukti publik aktif |
Gate sebelum release
| Gate | Command / check | Lulus jika |
|---|---|---|
| Build lokal | npm run build (di docs-site/docusaurus) | exit code 0 |
| Kontaminasi istilah lama | grep kata terlarang | tidak ada match |
| Halaman wajib ada | buka URL 4 halaman prioritas | HTTP 200 + marker konten benar |
| Sidebar parity | cek entry dokumen baru | halaman tampil di nav |
Daftar halaman prioritas parity
/docs/api-cookbook/docs/troubleshooting/docs/observability-ops/docs/release-parity-artifacts
Bukti minimum setelah deploy
| Bukti | Cara ambil |
|---|---|
| Deployment ID/URL | output command wrangler pages deploy |
| HTTP status halaman prioritas | curl -I [url] |
| Marker konten | `curl -s [url] |
Template laporan ringkas
Cycle: [n]
Build: PASS/FAIL
Deploy: PASS/FAIL (deployment url)
Contamination check: PASS/FAIL
Priority pages: PASS/FAIL per URL
Notes: [ringkas]