Skip to content

Instantly share code, notes, and snippets.

@veggiemonk
Forked from PurpleBooth/README-Template.md
Last active June 22, 2018 19:10
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 1 You must be signed in to fork a gist
  • Save veggiemonk/afc6e19c4efb672925561c202d6ce7d8 to your computer and use it in GitHub Desktop.
Save veggiemonk/afc6e19c4efb672925561c202d6ce7d8 to your computer and use it in GitHub Desktop.
A template to make good README.md

Project Title

One Paragraph of project description goes here

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

What things you need to install the software and how to install them

Give examples

Build

The command needed to compile/transpile the code into runnable code to the platform you're using

Run

A step by step series of examples that tell you have to get a development env running

Say what the step will be

Give the example

And repeat

until finished

End with an example of getting some data out of the system or using it for a little demo

Debugging

Sometimes we need to change things and we might not fully understand how it works.

List the commands and setup necessary to debug this application

Example:

npm run debug

or in your editor

Give an example

Tests

Explain how to run the automated tests for this system

Example:

npm run test

Debugging Tests

Explain what these tests test and why

Example:

npm run test:debug

Coding style tests

Explain what these tests test and why

Example:

npm run lint

Code Coverage

list the commands necessary to execute a code coverage

Example:

npm run coverage

Logging

There should be some logging convention that needs to be linked or outlined here

Deployment

Add additional notes about how to deploy this on a live system

Built With

  • Dropwizard - The web framework used
  • Maven - Dependency Management
  • ROME - Used to generate RSS Feeds

Acknowledgments

  • Hat tip to anyone who's code was used
  • Inspiration
  • etc
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment