Skip to content

Instantly share code, notes, and snippets.

@maephisto
Last active June 26, 2018 07:10
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save maephisto/9f7857b5d6fa2770c07984e5b6b76198 to your computer and use it in GitHub Desktop.
Save maephisto/9f7857b5d6fa2770c07984e5b6b76198 to your computer and use it in GitHub Desktop.
Module README template

Package name

Short description about the intended purpose of the package.E.g. This package offers a way to create and manage dragons.

Usage

How does one use this package? Provide examples. E.g. Package can be installed from NPM registry via npm i dragon

Package API

Documents the public API fo the module. E.g. Creating a new dragon

import dragon from 'dragon'
const newDragon = dragon.createDragon({ name: 'Drogon', age: 2000 })

Domesticating a dragon

import dragon from 'dragon'
const newDragon = dragon.createDragon({ name: 'Drogon', age: 2000 })
newDragon.domesticate();

Development

Short guide on how to start development of the package.Instructions that will get you a copy of the package on your local machine for development and testing purposes.

Prerequisites

What does one need pre-installed or prepared before running this package. E.g.

  • Node.js >= 9.00
  • npm > 5.0.0
  • jest

Running tests

How does one run the testsuite (and code cov if available). E.g.

Run the test suite with npm test Verify the code coverage with npm run codecov

Deployment

How does one deploy a new version of the package. E.g. To deploy a new version increase the version via npm version patch and create a new release/tag.

Contributing

Short set of guidelines (if any) for contributing to the development of this project. E.g.

  • Increase code coverage, do not decrease it
  • Update the changelist

Changelist

A summary of the changes included in each version. E.g.

  • v1.2.0 Added new feature
  • v1.1.0 Extended API method
  • v1.0.0 Initial version
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment