In this article

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:

SectionIsiPertanyaan yang dijawab
ResearchFakta, data, audit, kompetitor, sumberApa yang kita tahu?
StrategyPositioning, SWOT, peluang, persona, produk, KPIKe mana kita pergi dan kenapa?
Visual DirectionAudit brand, palet, tipografi, UI, motionSeperti 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:

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:

    ---
    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.