README

Dalam distribusi dan pengembangan perangkat lunak, berkas README berisi informasi tentang berkas-berkas lain dalam direktori atau arsip perangkat lunak komputer. Sebagai bentuk dokumentasi, berkas ini biasanya berupa berkas teks biasa yang disebut README, Read Me, READ.ME, README.txt, atau README.md (untuk menunjukkan penggunaan Markdown).

Nama berkas umumnya ditulis dalam huruf kapital. Khususnya pada sistem mirip Unix, hal ini membuatnya tampak mencolok – baik karena nama berkas dengan huruf kecil lebih umum, maupun karena perintah ls biasanya mengurutkan dan menampilkan berkas dalam urutan kode ASCII, di mana nama berkas dengan huruf kapital akan muncul terlebih dahulu.

Konten

Berkas README biasanya meliputi:

Petunjuk konfigurasi
Petunjuk instalasi
Petunjuk pengoperasian
Manifes berkas (daftar berkas dalam direktori atau arsip)
Informasi hak cipta dan lisensi
Informasi kontak untuk distributor atau penulis
Daftar kutu yang diketahui^[1]
Petunjuk pemecahan masalah^[1]
Penghargaan dan ucapan terima kasih
Catatan perubahan (biasanya ditujukan kepada sesama programmer)
Bagian berita (biasanya ditujukan untuk pengguna akhir)

Sejarah

Tidak jelas sejak kapan kebiasaan penambahan berkas ini dimulai, namun ada beberapa contoh yang berasal dari pertengahan tahun 1970-an.^[2]^[3]

Secara khusus, ada sejarah panjang tentang perangkat lunak bebas dan perangkat lunak sumber terbuka yang memasukkan berkas README ke dalam sebuah proyek; sebenarnya itu adalah persyaratan dalam Standar Koding GNU.^[4]

Sejak kemunculan web sebagai platform standar untuk distribusi perangkat lunak, banyak paket-paket perangkat lunak telah memindahkan (atau kadang-kadang menyalin) beberapa berkas tambahan dan potongan informasi ke situs web atau wiki, terkadang termasuk README itu sendiri, atau terkadang hanya meninggalkan berkas README singkat tanpa semua informasi yang dibutuhkan oleh pengguna baru perangkat lunak.

Baru-baru ini, penyedia layanan populer repositori Git milik GitHub^[5] sangat menganjurkan menambahkan berkas README. Jika berkas tersebut berada di bagian direktori utama, maka berkas README tersebut akan ditampilkan secara otomatis di halaman web utama. Sementara jenis teks biasa, berbagai berkas dengan ekstensi dan format yang berbeda juga telah didukung,^[6] dan dikonversi ke HTML.

Istilah umum

Ungkapan berkas "README" juga kadang-kadang lumrah digunakan untuk berkas dengan tujuan yang sama. Misalnya, distribusi kode sumber dari banyak paket perangkat lunak bebas, terutama yang mengikuti Standar Gnits atau yang diproduksi dengan GNU Autotools. Berikut adalah satu set standar berkas README:

`README`	Informasi umum
`AUTHORS`	Kredit
`THANKS`	Ucapan terima kasih
`CHANGELOG`	Sebuah rincian catatan perubahan, ditujukan untuk pemrogram
`NEWS`	Sebuah catatan perubahan sederhana, ditujukan untuk pengguna
`INSTALL`	Petunjuk instalasi
`COPYING` / `LICENSE`	Informasi hak cipta dan perizinan
`BUGS`	Kekutu yang diketahui dan petunjuk untuk melaporkan kekutu yang baru
`CONTRIBUTING` / `HACKING`	Panduan cara berkontribusi ke dalam proyek

Berkas lain yang umum didistribusikan dengan perangkat lunak yang berisi README adalah FAQ dan daftar TODO yang berisi informasi perubahan di masa mendatang.