Skip to content

Instantly share code, notes, and snippets.

@miguelpardal
Forked from PurpleBooth/README-Template.md
Last active April 16, 2024 15:26
Show Gist options
  • Save miguelpardal/36f6ef7864bfdeabe5c57b161aa80f2f to your computer and use it in GitHub Desktop.
Save miguelpardal/36f6ef7864bfdeabe5c57b161aa80f2f to your computer and use it in GitHub Desktop.
A template to make good README.md files for software components

Project Title

Begin with an introductory paragraph that tells readers the purpose of the project and its main features.
Provide a summary of the information included in this document.

General Information

This section expands on the introductory paragraph to give readers a better understanding of the project and its purpose.

Built With

Include an outline of the technologies in the project, such as platform, programming language, framework, etc.

If you mention something, please provide links.

  • Java - Programming Language and Platform
  • Maven - Build Tool and Dependency Management
  • ...

Getting Started

Provide instructions to get a copy of the project up and running on your a machine.

Prerequisites

What kind of hardware and operating system do you need to have to install the software?

In this section also include detailed instructions for installing additional software the application is dependent upon (such as a database, for example).

$ installation command 

Installing

Give step-by-step instructions on building and running the project.

Describe the step.

$ command1

And repeat until finished. Describe the expected outcomes of each command, including screenshots, when relevant.

$ command2

Testing

Explain how to run the (automated) tests for the project.

Explain the tests and their expected outcome.

$ test command

Demo

Give a tour of the best features of the application.
Add screenshots when relevant.

Deployment

Add additional notes about how to deploy this on a server machine or a cloud provider.

Mention virtualization/container tools and commands.

$ deployment command

Provide instructions for connecting to servers and tell clients how to obtain necessary permissions.

Additional Information

Authors

See also the list of contributors who participated in this project.

Versioning

SemVer used for versioning.
For the versions available, see the tags on this repository.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Acknowledgments

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