Tentang & Kontribusi

Kenapa MarkCache ada, prinsip kurasi yang dipakai, dan cara menambah atau melaporkan link lewat vault Obsidian maupun PR.

Diperbarui 7 Nov 2026 · Ditambahkan 19 Des 2025


Tentang MarkCache

MarkCache adalah situs direktori tautan terkurasi ala FMHY dengan pendekatan ID-first: deskripsi ditulis dalam bahasa Indonesia, nama tool tetap mengikuti nama global, dan layanan atau komunitas Indonesia diprioritaskan.

Prinsip kurasi

  • Link layak masuk jika: domain aktif, gratis, deskripsi satu kalimat jelas, dan tidak dobel dengan link lain di halaman yang sama.
  • Link dicabut jika: domain mati, paywall total (tanpa tier gratis), atau scam, atau bisa merugikan pengunjung.
  • Kategori kosong tidak ditampilkan: yang belum terisi diperlihatkan sebagai "segera hadir" di landing.

Tidak perlu menyalin repo. Buka New issue dan pilih formulir Lapor Link Mati: tulis URL-nya, halaman MarkCache di mana link itu berada, dan gejalanya. Alternatif aktif (bila kamu tahu) sangat membantu kurasi. Laporan lewat issue ini lebih mudah ditindak karena terstruktur dan mudah dicari.

Cara kontribusi

  1. Buka repo di editor, atau content/ langsung sebagai vault Obsidian (lihat content/_vault-guide.md).
  2. Untuk kategori baru, salin content/_templates/kategori.md menjadi content/<nama-kategori>/index.md.
  3. Isi body: satu ## Subkategori per topik, tiap resource satu bullet - [Nama](https://example.com) — deskripsi singkat. \tag``.
  4. Jalankan linter sebelum commit:
    node scripts/contentlint.mjs --fix
    
  5. Kirim PR. Checklist format akan muncul otomatis. Pemilik repo akan meninjau sebelum merge (pola solo-curated + open-contrib).

Aturan format (v1)

Satu folder = satu kategori, index.md = halaman kategori. Frontmatter minimal: title, description, category, domain, icon, order, tags, updated, draft, featured. domain menentukan grup di landing dan sidebar (hiburan, dev, utilitas, meta), sedangkan icon dan order dipakai kartu kategori di landing. Dilarang memakai wikilink kurung-siku-ganda, embed seru-plus-siku, Dataview, atau komponen MDX di dalam content/ supaya file tetap bisa dibuka enak di Obsidian.

Halaman content/directory.md (Index) di-generate oleh node scripts/gen-index.mjs dari frontmatter + H2 tiap kategori — jangan diedit manual. Script jalan otomatis saat dev/build dan di pre-commit, jadi index tidak pernah basi.

Stack

Nuxt 4 + @nuxt/content, prerender statis, search ⌘K berbasis Fuse, dark mode, dan linter konten khusus (contentlint).