Skip to content

Instantly share code, notes, and snippets.

@martindale
Last active August 29, 2015 14:03
Show Gist options
  • Star 1 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save martindale/7a6fdbb6a95e9badd4f1 to your computer and use it in GitHub Desktop.
Save martindale/7a6fdbb6a95e9badd4f1 to your computer and use it in GitHub Desktop.
README.md Template

Getting Started

Overview

One or two paragraph introduction on the objective of this library.

Quick Start

If you are unsure of our project and just want to play around, you can get things set up quickly by:

  1. Clone this repository and…
  2. Do something
  3. Do the other thing

If you need more detailed instructions, have no fear. We are not going to look down on you if you are not an expert. We took the time to write a setup guide for newcomers: [Novice setup guide][novice-setup-guide]. Everybody has to start somewhere.

Real Start

Follow these instructions if you wish to deploy your own version or contribute back to the project. There is nothing we hate more than README’s that ignore all of the practical concerns related to setting up a long term installation. Follow these steps and it will be easy for you to keep up with updates to the project and still retain the all tweaks you made to suit your idiosyncrasies.

Odds and Ends

Optional features

Not everybody needs a XYZ plugin or wants to share their every action with PQR. You can enable these features by…

Rare Corner cases

In certain rare circumstances you made need to prevent X or implement Y.

Prevent X by…

If you need to implement Y…

Troubleshooting

Contact support via our official helpdesk or ask the community.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment