Name of the project

Additional information or tagline

Microservices template for quick prototyping and rapid application development.

• dotenv is used to load environment variables from .env file into process.env. The .env file should not be committed to a repo as it might contain secrets.
• The testing library are mocha and chai.
• Linting with eslint configured with the google style.

Installing / Getting started

A quick introduction of the minimal setup you need to get a hello world up & running.

npm install
npm start

Here you should say what actually happens when you execute the code above.

Initial Configuration

Some projects require initial configuration (e.g. access tokens or keys, npm i). This is the section where you would document those requirements.

Developing

Here's a brief intro about what a developer must do in order to start developing the project further:

git clone https://github.com/billymfl/awesome-project.git
cd awesome-project/
npm install

And state what happens step-by-step.

Building

If billymfl project needs some additional steps for the developer to build the project after some code changes, state them here:

./configure
make
make install

Here again you should state what actually happens when the code above gets executed.

Deploying / Publishing

In case there's some step you have to take that publishes this project to a server, this is the right time to state it.

docker build -t app:version .

And again you'd need to tell what the previous code actually does.

Features

What's all the bells and whistles this project can perform?

• What's the main functionality
• You can also do another thing
• If you get really randy, you can even do this

Configuration

Here you should write what are all of the configurations a user can enter when using the project.

Argument 1

Type: String
Default: 'default value'

State what an argument does and how you can use it. If needed, you can provide an example below.

Example:

awesome-project "Some other value"  # Prints "You're nailing this readme!"

Argument 2

Type: Number|Boolean
Default: 100

Copy-paste as many of these as you need.

Contributing

When you publish something open source, one of the greatest motivations is that anyone can just jump in and start contributing to billymfl project.

These paragraphs are meant to welcome those kind souls to feel that they are needed. You should state something like:

"If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome."

If there's anything else the developer needs to know (e.g. the code style guide), you should link it here. If there's a lot of things to take into consideration, it is common to separate this section to its own file called CONTRIBUTING.md (or similar). If so, you should say that it exists here.

Links

Even though this information can be found inside the project on machine-readable format like in a .json file, it's good to include a summary of most useful links to humans using billymfl project. You can include links like:

• Project homepage: https://billymfl.github.com/awesome-project/
• Repository: https://github.com/billymfl/awesome-project/
• Issue tracker: https://github.com/billymfl/awesome-project/issues
  • In case of sensitive bugs like security vulnerabilities, please contact [email protected] directly instead of using issue tracker. We value billymfl effort to improve the security and privacy of this project!
• Related projects:
  • billymfl other project: https://github.com/billymfl/other-project/
  • Someone else's project: https://github.com/billymfl/simple-microservice-template/

Licensing

The code in this project is licensed under MIT license.