---
title: Tentang dokumentasi ini
intro: Untuk siapa dokumen ini, cara membacanya, aturan bukti, dan cara menambah halaman baru.
updated: 1 Nov 2026
---

## 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](/research/) | Fakta, data, audit, kompetitor, sumber | Apa yang kita tahu? |
| [Strategy](/strategy/) | Positioning, SWOT, peluang, persona, produk, KPI | Ke mana kita pergi dan kenapa? |
| [Visual Direction](/visual-direction/) | Audit brand, palet, tipografi, UI, motion | Seperti apa rasanya? |

## Aturan bukti

Setiap halaman mengikuti aturan yang sama:

1. **Setiap klaim punya sumber.** Link ke artikel, akun, atau halaman resmi, atau tangkapan layar di `assets/evidence/`.
2. **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.
3. **Tanggal selalu ditulis.** Angka media sosial berubah, jadi setiap angka diberi tanggal pengambilan.
4. **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:

```text
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:

1. Buat file baru, misalnya `content/research/sponsor-xs3.md`, dengan frontmatter:

   ```markdown
   ---
   title: Sponsor XSERIES-3
   intro: Daftar sponsor yang diumumkan untuk XS-3.
   updated: 15 Des 2026
   status: Draft
   ---

   ## Bagian pertama
   Isi...
   ```

2. Tambahkan entri `{ "slug": "sponsor-xs3", "title": "Sponsor XSERIES-3" }` ke grup yang sesuai di `nav.json`.
3. Simpan gambar bukti di `assets/evidence/` lalu panggil dengan `![alt](/assets/evidence/nama.jpg "Caption dan sumber")`. Beberapa gambar dalam satu paragraf otomatis menjadi galeri.
4. Jalankan `npm run build` (atau `npm run serve` untuk build dan buka di `http://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.