Project Title
Provide an introductory paragraph, describing:
- What your project does
- Why people should consider using your project
- Link to project home page
Table of Contents
- About the Project
- Project Status
- Getting Started
- Release Process
- How to Get Help
- Contributing
- Further Reading
- License
- Authors
- Acknowledgments
About the Project
Here you can provide more details about the project
- What features does your project provide?
- Short motivation for the project? (Don't be too long winded)
- Links to the project site
Show some example code to describe what your project does
Show some of your APIs
Project Status
Show the build status if you have a CI server:
Describe the current release and any notes about the current state of the project. Examples: currently compiles on your host machine, but is not cross-compiling for ARM, APIs are not set, feature not implemented, etc.
Getting Started
This section should provide instructions for other developers to
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.
Dependencies
Describe what software and libraries you will need to install in order to build and use this project. Provide details on how to resolve these dependencies.
Remember: git-lfs
is a dependency that developers will need to resolve before they can get started with a repository using LFS.
Examples should be included
Getting the Source
Include a link to your GitHub repository (you have no idea how people will find your code), and also a summary of how to clone.
This project is hosted on GitHub. You can clone this project directly using this command:
git clone git@github.com:embeddedartistry/templates.git
Building
Instructions for how to build your project
Examples should be included
Running Tests
Describe how to run unit tests for your project.
Examples should be included
Other Tests
If you have formatting checks, coding style checks, or static analysis tests that must pass before changes will be considered, add a section for those and provide instructions
Installation
Instructions for how to install your project's build artifacts
Examples should be included
Usage
Instructions for using your project. Ways to run the program, how to include it in another project, etc.
Examples should be included
If your project provides an API, either provide details for usage in this document or link to the appropriate API reference documents
Release Process
Talk about the release process. How are releases made? What cadence? How to get new releases?
Versioning
This project uses Semantic Versioning. For a list of available versions, see the repository tag list.
Payload
How to Get Help
Provide any instructions or contact information for users who need to get further help with your project.
Contributing
Provide details about how people can contribute to your project. If you have a contributing guide, mention it here. e.g.:
We encourage public contributions! Please review CONTRIBUTING.md for details on our code of conduct and development process.
Further Reading
Provide links to other relevant documentation here
License
Copyright (c) 2021 Embedded Artistry LLC
This project is licensed under the XXXXXX License - see LICENSE.md file for details.
Authors
- Phillip Johnston - Initial work - Embedded Artistry
Also see the list of contributors who participated in this project.
Acknowledgments
Provide proper credits, shout-outs, and honorable mentions here. Also provide links to relevant repositories, blog posts, or contributors worth mentioning.