README

Project's front page

A README is a text file included with software or code repositories that explains what the project does, how to install it, and how to use it.

The name literally instructs: read me first.

READMEs serve as the entry point for anyone encountering unfamiliar code: Check the README for setup instructions.

The format has become standard in open-source development, typically written in plain text or Markdown.

documentation

file

Stored collection of data

overview · introduction · markdown · repository · project · description · installation · usage · license · contributing

software

GitHub

Web-based code hosting service

clone · fork · commit · version · release · developer · maintainer · contributor · package · library

format

markdown

Reduction in retail price

preview · formatting · headings · bullets · links · images · tables · syntax · extension · editor

Categories
Opposites
documentation vs. code

READMEsource code

Programming instructions before compilation

executable · binary · code · compiled code · script

introductory vs. advanced documentation

READMEman page

Unix command documentation

public guidance vs. hidden/ignored content

READMEhidden file

Invisible stored data

private key · config file

Phrases
Family

read, reads, reader, readers, reading, readings, readable, unreadable, readability

Familiarity
Top 500,000
Profile
Used worldwide · Timeless · Concrete · Rated G