A template for README files that can be used for your future projects. A small description about the project, shields as well as the link to your repo.
Open and view the Project using the .zip
file provided or at my GitHub Repository
The project is also hosted on GitHub Pages
- Getting Started
- Development
- Running the App
- Deployment
- Contributing
- Versioning
- Authors
- License
- Acknowledgments
The project might have multiple branches: master
, development
, etc. which can be explained here
master
contains aggregate code of all branchesdevelopment
contains code under development
Other details that need to be given while starting out with the project can be provided in this section. A project structure like below can also be included for the big projects:
project-title
├── README.md
├── package.json
├── .gitignore
├── public
│ ├── favicon.ico
│ ├── index.html
│ └── manifest.json
└── src
├── App.css
├── App.js
├── App.test.js
├── index.css
├── index.js
├── logo.svg
└── serviceWorker.js
└── setupTests.js
All tools required go here. You would require the following tools to develop and run the project:
- A text editor or an IDE (like IntelliJ)
- Mention the other tools required for the project
All installation steps go here.
-
Installing a particular tool
- Steps to complete it
-
Installing another tool
This section is completely optional. For big projects, the developement strategies are not discussed. But for small projects, you can give some insight to people. It has 2 benefits in my opinion:
- It's a way to give back to the community. People get to learn from you and appreciate your work
- You can refer the README in future as a quick refresher before an interview or for an old project to check if it can help you in your currect work
- Mention the steps here
- You can also have nested steps to break a step into small tasks
- Mention the steps here.
- You can also have nested steps to break a step into small tasks
For details now how everything has been implemented, refer the source code
- Mention the steps here
Steps and commands for running the app are to be included here
- Example steps:
Example command
This section is completely optional. Add additional notes about how to deploy this on a live system
Mention what you expect from the people who want to contribute
We'd love to have your helping hand on Project Title
! See CONTRIBUTING.md for more information on what we're looking for and how to get started.
If your project has multiple versions, include information about it here.
For the available versions, see the tags on this repository
You can also see the complete list of contributors who participated in this project.
Project Title
is open source software licensed as MIT.
This section can also be called as Resources
or References
- Code Honor if someone's work was referred to
- Tutorials followed
- Articles that helped
- Inspiration
- etc