> ## Documentation Index
> Fetch the complete documentation index at: https://docs.daekan.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Contributing Docs

> Panduan internal untuk mengembangkan dokumentasi Daekan di repo Mintlify ini.

<Info>
  Dokumentasi ini dibangun dengan Mintlify. Halaman ini khusus untuk tim internal yang mengelola repo docs.
</Info>

## Jalankan preview lokal

<Steps>
  <Step title="Install the Mintlify CLI">
    ```bash theme={null}
    npm i -g mint
    ```
  </Step>

  <Step title="Preview locally">
    ```bash theme={null}
    mint dev
    ```

    Preview lokal biasanya tersedia di `http://localhost:3000`.
  </Step>
</Steps>

## Struktur konten yang dipakai

<AccordionGroup>
  <Accordion title="Guide">
    Berisi onboarding, panduan operasional, best practice, dan troubleshooting produk.
  </Accordion>

  <Accordion title="API Reference">
    Berisi autentikasi, endpoint inti, payload contoh, dan webhook.
  </Accordion>

  <Accordion title="Blog">
    Berisi artikel edukasi untuk user dan calon user, bukan changelog teknis repo.
  </Accordion>
</AccordionGroup>

## Prinsip penulisan

<Checklist>
  <Check>Gunakan bahasa Indonesia yang natural dan langsung ke use case</Check>
  <Check>Prioritaskan kejelasan alur, contoh payload, dan outcome user</Check>
  <Check>Jangan ubah gaya visual brand; cukup rapikan struktur, copy, dan navigasi</Check>
  <Check>Jika fitur masih berkembang, tandai statusnya dengan jujur</Check>
</Checklist>

## Validasi sebelum commit

```bash theme={null}
mint broken-links
```

## Jika port bentrok

```bash theme={null}
mint dev --port 3333
```

## Troubleshooting authoring

<AccordionGroup>
  <Accordion title="Preview tidak jalan">
    Pastikan Node.js sudah sesuai dan `mint` terpasang global. Jika perlu, reinstall dengan `npm i -g mint`.
  </Accordion>

  <Accordion title="Link internal rusak">
    Jalankan `mint broken-links`, lalu cek slug halaman di `docs.json` dan frontmatter tiap file MDX.
  </Accordion>
</AccordionGroup>