README

Een README-bestand (Engels: read me = 'lees mij') is een computerbestand dat vaak bij een softwarepakket wordt geleverd, en dat belangrijke algemene informatie bevat waarvan de ontwikkelaars of verspreiders menen dat de gebruiker die eerst moet lezen, voorafgaand aan compilatie, installatie of eerste gebruik. De bestandsnaam wordt traditioneel in hoofdletters geschreven en kan, behalve README ook README.TXT of READ.ME heten, of andere varianten daarop.

Inhoud

De inhoud van README-bestanden is vaak gestandaardiseerd binnen softwareprojecten en volgt dan een vast stramien. Dit wordt gedaan om alle te behandelen onderwerpen af te vangen en om een vaste en duidelijke presentatie naar de gebruiker toe te hebben. Als README-bestanden door een overvloed aan informatie te lang worden, wordt er vaak een nieuw bestand aangemaakt met een toepasselijke naam, en wordt eventueel in het README-bestand hier naar verwezen. Veel voorkomende onderwerpen bij README-files zijn:

OnderwerpAlternatief bestand
Copyright- en licentieinformatieCOPYING / LICENSE
Informatie over de programmeur of distributeurAUTHORS
ConfiguratiehandleidingCONFIGURE
InstallatiehandleidingINSTALL
GebruikershandleidingMANUAL / HELP
Lijst met bestanden die wordt meegeleverd met het pakketMANIFEST
Bekende bugsBUGS
ChangelogCHANGELOG / NEWS

Zie ook