moodmosaic (Nikos Baxevanis)
Blog - About - Open Source - Bookmarks - Tags

GitHub README layouts

Sunday, 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.

━━━

This post has been filed under #miscellaneous

Feedback

Have feedback on this page? Let @nikosbaxevanis know on twitter. Need help or found a bug? Contact me.


© 2011-2018 Nikos Baxevanis. All written content on this site is provided under a Creative Commons ShareAlike license. All code is provided under a MIT license unless otherwise stated.