Skip to content

Instantly share code, notes, and snippets.

@indexzero
Created November 9, 2011 01:54
Show Gist options
  • Save indexzero/1350071 to your computer and use it in GitHub Desktop.
Save indexzero/1350071 to your computer and use it in GitHub Desktop.
The least amount of guidelines possible to maintain 150+ open source node.js modules

Guidelines for Open Source at Nodejitsu

README.md Outline

  • Header
    • Brief description (should match package.json)
  • Example (if applicable)
  • Motivation (if applicable)
  • API Documentation: This will likely vary considerably from library to library.
  • Installation
  • Tests
  • Contributors
  • License

Bonus Points

  1. The file is named exactly README.md (not ReadMe.md, or README)
  2. The license file is named exactly LICENSE (not MIT-LICENSE, or license)
  3. The entire license is not included in README.md, just a snippet saying it is MIT or Apache or whatever
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment