README: Perbedaan antara revisi
k Menambah Kategori:Komputer menggunakan HotCat |
Menambahkan Sejarah dan perbaikan bahasa. Tag: Suntingan visualeditor-wikitext |
||
| Baris 9: | Baris 9: | ||
== Konten == |
== Konten == |
||
Konten dari README biasanya mencakup satu atau beberapa hal sebagai berikut: |
Konten dari README biasanya mencakup satu atau beberapa hal sebagai berikut: |
||
* |
* Petunjuk [[konfigurasi]]. |
||
* |
* Petunjuk [[instalasi]]. |
||
* |
* Petunjuk pengoperasian. |
||
* Sebuah berkas manifest. |
* Sebuah berkas manifest. |
||
* Informasi [[Hak_cipta|hak cipta]] dan [[Lisensi|perizinan]]. |
* Informasi [[Hak_cipta|hak cipta]] dan [[Lisensi|perizinan]]. |
||
| Baris 20: | Baris 20: | ||
* Sebuah [[changelog]] (biasanya untuk pemrogram). |
* Sebuah [[changelog]] (biasanya untuk pemrogram). |
||
* Bagian berita (biasanya untuk pengguna). |
* Bagian berita (biasanya untuk pengguna). |
||
== Sejarah == |
|||
Tidak jelas kapan konvensi tersebut dimulai, namun ada beberapa contoh yang berasal dari pertengahan tahun 1970an.<ref>http://pdp-10.trailing-edge.com/decuslib10-04/index.html</ref><ref>http://pdp-10.trailing-edge.com/decus_20tap3_198111/01/decus/20-0079/readme.txt.html</ref> |
|||
Secara khusus, ada sejarah panjang [[perangkat lunak bebas]] dan [[perangkat lunak sumber terbuka]] memasukkan berkas README ke dalam sebuah proyek; sebenarnya itu adalah persyaratan dalam [[Standar Koding GNU]]. |
|||
Sejak kemunculan [[web]] sebagai platform standar untuk distribusi perangkat lunak, banyak 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, sangat menganjurkan menambahkan berkas README - jika berkas tersebut berada di bagian direktori tingkat atas, 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 sudah didukung, dan dikonversi ke HTML. |
|||
== Istilah umum == |
== Istilah umum == |
||
| Baris 41: | Baris 50: | ||
|- |
|- |
||
|<tt>INSTALL</tt> |
|<tt>INSTALL</tt> |
||
| |
|Petunjuk instalasi |
||
|- |
|- |
||
|<tt>COPYING</tt> / <tt>LICENSE</tt> |
|<tt>COPYING</tt> / <tt>LICENSE</tt> |
||
| Baris 47: | Baris 56: | ||
|- |
|- |
||
|<tt>BUGS</tt> |
|<tt>BUGS</tt> |
||
|Kekutu yang diketahui dan petunjuk untuk melaporkan yang baru |
|Kekutu yang diketahui dan petunjuk untuk melaporkan kekutu yang baru |
||
|- |
|- |
||
|} |
|} |
||
| Baris 59: | Baris 68: | ||
{{reflist|30em}} |
{{reflist|30em}} |
||
[[Kategori: |
[[Kategori:Perangkat_lunak]] |
||
[[Kategori:Platform komputer]] |
|||
Revisi per 17 Januari 2018 21.58
README adalah sebuah berkas yang berisi informasi tentang berkas lain di dalam direktori atau arsip perangkat lunak komputer. Sebuah bentuk dokumentasi, biasanya adalah berkas teks sederhana yang bernama READ.ME, README.TXT, README.md (untuk berkas teks yang menggunakan markup markdown), README.1ST – atau hanya README.
Nama berkas pada umumnya ditulis dalam huruf besar. Pada sistem operasi bertipe Unix, hal ini membuat berkas README mudah diperhatikan.
Konten
Konten dari README biasanya mencakup satu atau beberapa hal sebagai berikut:
- Petunjuk konfigurasi.
- Petunjuk instalasi.
- Petunjuk pengoperasian.
- Sebuah berkas manifest.
- Informasi hak cipta dan perizinan.
- Informasi kontak untuk distributor atau pemrogram.
- Kekutu yang diketahui.[1]
- Troubleshooting.[1]
- Kredit dan ucapan terima kasih.
- Sebuah changelog (biasanya untuk pemrogram).
- Bagian berita (biasanya untuk pengguna).
Sejarah
Tidak jelas kapan konvensi tersebut dimulai, namun ada beberapa contoh yang berasal dari pertengahan tahun 1970an.[2][3]
Secara khusus, ada sejarah panjang perangkat lunak bebas dan perangkat lunak sumber terbuka memasukkan berkas README ke dalam sebuah proyek; sebenarnya itu adalah persyaratan dalam Standar Koding GNU.
Sejak kemunculan web sebagai platform standar untuk distribusi perangkat lunak, banyak 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, sangat menganjurkan menambahkan berkas README - jika berkas tersebut berada di bagian direktori tingkat atas, 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 sudah didukung, dan dikonversi ke HTML.
Istilah umum
Ungkapan berkas "README" juga kadang-kadang digunakan secara umum, 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 changelog, ditujukan untuk pemrogram NEWS Sebuah changelog dasar, ditujukan untuk pengguna INSTALL Petunjuk instalasi COPYING / LICENSE Informasi hak cipta dan perizinan BUGS Kekutu yang diketahui dan petunjuk untuk melaporkan kekutu yang baru
Berkas lain yang umum didistribusikan dengan perangkat lunak yang berisi README adalah FAQ dan daftar TODO yang berisi informasi perubahan di masa depan.
Lihat pula
Referensi
- ^ a b Manes, Stephen (November 1996). "README? Sure--before I buy!". PC World. 14 (11): 366.
- ^ http://pdp-10.trailing-edge.com/decuslib10-04/index.html
- ^ http://pdp-10.trailing-edge.com/decus_20tap3_198111/01/decus/20-0079/readme.txt.html