Skip to content

Instantly share code, notes, and snippets.

@anoff
Last active August 16, 2017 17:47
Show Gist options
  • Save anoff/83cdf35d8e92ec1403a2b16dfc84b513 to your computer and use it in GitHub Desktop.
Save anoff/83cdf35d8e92ec1403a2b16dfc84b513 to your computer and use it in GitHub Desktop.
Readme Template

MyTool {Title/Reponame}

Helps you build things {one-line purpose}

{} = Explanations for this readme..

Maybe here is a small overview of how MyTool, should not be longer than 5 lines and you're invited to use emojis 👯.

{Headings defined here are required (unless not implemented) but you're free to add custom headings above License}

Setup {Install instructions}

Prerequisites

  • Python >=2.6 & < 3
  • GNU compiler
  • node >= 8

Installation

{Please make sure you have simple installation instructions or bundle them into a Makefile}

npm install
# or python
make install

Usage {Describe how to use the component}

Bootstrap environment

MyTool needs the following supporting components to run on your system:

  • MySQL 2.9.3 at 2701
  • Redis 3 at 3102

To start them in a docker environment you can use the following command:

{Make sure that this command is also not overly long}

make env-up

Start

There are two ways to start MyTool

npm run
# or python
make run / python tool.py

or you can use docker run openmined/mytool to start a prepared docker container with the latest release.

Tests

You can run codestyle checks with

make lint
# or nodeJS
npm lint

And unit tests with make test

Mystuff {you can add individual headings at this point}

I want to thank my mom and dad for giving me a computer when I was 8 years old.

License

SPDX License name by OpenMined contributors

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