Tentang dokumentasi ini
Untuk siapa dokumen ini, cara membacanya, aturan bukti, dan cara menambah halaman baru.
Tujuan
Dokumentasi ini adalah basis kerja untuk membangun website dan produk digital XSERIES. Isinya dibagi tiga, sesuai pilihan di dropdown Select section di header:
| Section | Isi | Pertanyaan yang dijawab |
|---|---|---|
| Research | Fakta, data, audit, kompetitor, sumber | Apa yang kita tahu? |
| Strategy | Positioning, SWOT, peluang, persona, produk, KPI | Ke mana kita pergi dan kenapa? |
| Visual Direction | Audit brand, palet, tipografi, UI, motion | Seperti apa rasanya? |
Aturan bukti
Setiap halaman mengikuti aturan yang sama:
- Setiap klaim punya sumber. Link ke artikel, akun, atau halaman resmi, atau tangkapan layar di
assets/evidence/. - Bedakan fakta dan dugaan. Fakta ditulis biasa. Dugaan diberi label "kemungkinan" atau dimasukkan ke callout Catatan. Rekomendasi ada di Strategy dan Visual Direction, bukan di Research.
- Tanggal selalu ditulis. Angka media sosial berubah, jadi setiap angka diberi tanggal pengambilan.
- Status halaman ditampilkan di bawah judul:
Terverifikasi(fakta dengan sumber),Draft(masih bisa berubah),Hipotesis(rekomendasi yang perlu divalidasi).
Evidence
Callout seperti ini menandai bukti visual atau kutipan langsung dari sumber.
Cara menambah halaman
Situs ini dibangun dari file markdown. Struktur foldernya:
site/
├── nav.json # urutan section, grup, dan halaman di sidebar
├── content/
│ ├── research/*.md
│ ├── strategy/*.md
│ └── visual-direction/*.md
├── assets/evidence/ # tangkapan layar dan media bukti
├── build.mjs # mengubah markdown jadi HTML statis
└── dist/ # hasil build (jangan diedit manual)
Langkahnya:
Buat file baru, misalnya
content/research/sponsor-xs3.md, dengan frontmatter:--- title: Sponsor XSERIES-3 intro: Daftar sponsor yang diumumkan untuk XS-3. updated: 15 Des 2026 status: Draft --- ## Bagian pertama Isi...Tambahkan entri
{ "slug": "sponsor-xs3", "title": "Sponsor XSERIES-3" }ke grup yang sesuai dinav.json.Simpan gambar bukti di
assets/evidence/lalu panggil dengan. Beberapa gambar dalam satu paragraf otomatis menjadi galeri.Jalankan
npm run build(ataunpm run serveuntuk build dan buka dihttp://127.0.0.1:4417).
Fitur penulisan
- Callout:
> [!NOTE],> [!TIP],> [!IMPORTANT],> [!WARNING],> [!CAUTION], dan> [!EVIDENCE]. - Swatch warna: tulis kode hex di dalam backtick, misalnya
#22d3e6, maka chip warnanya muncul otomatis. - Galeri bukti: letakkan beberapa gambar berurutan tanpa baris kosong di antaranya. Klik gambar untuk memperbesar.
- Copy markdown: tombol di bawah judul menyalin isi halaman sebagai markdown, berguna untuk ditempel ke brief atau prompt AI.
- Search: tekan
/di mana saja.