Tips Menulis README yang Bisa Dipahami dalam 30 Detik

Struktur README yang membantu orang lain memakai proyek kamu tanpa nanya ulang.

README yang baik tidak harus panjang. Yang penting orang bisa menjalankannya dalam 30 detik.

Struktur singkat

  1. Apa ini.
  2. Kenapa cocok.
  3. Cara pakai.
  4. Batasan atau kebutuhan khusus.

Detail yang sering dilupakan

Jangan lupa menulis versi tools yang dipakai dan cara verifikasi hasil akhirnya. Itu mencegah pertanyaan berulang.

Contoh manfaatnya

Ketika README jelas, orang akan mengirimkan issue yang lebih spesifik. Kamu juga bisa kembali ke proyek sendiri setelah lama tanpa harus membacanya ulang dari nol.