λ>_

GitHub README layouts

01 June 2014

In most common scenarios, README files can have one of the following layouts.

Basic

The basic layout might seems too much in the beginning, but I think this is quite essential and valuable information that each open source project could have.

Being able to scan through each of these sections saves a lot of time.

Extended

Including these additional sections in the README almost eliminates the need to write an introductory blog post about the project.

Mature

As the project becomes bigger and successful, these additional sections tend to minimize potential duplicate questions on Stack Overflow and questions as issues on GitHub.


1 The description for the maturity levels of open source code can be found here.