qwertyiscoding / readme-generator Goto Github PK

An Awesome ReadME Generator To Jumpstart Your Projects!
Note This Project Is Still W.I.P

View Demo »

Explore the docs . Report Bug . Request Feature

• Table Of Contents
• About The Project
• Built With
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Roadmap
• Contributing
  • Creating A Pull Request
• License
• Authors
• Acknowledgements

There are many great ReadME templates available on GitHub, however, I struggled to find any ReadME generators. Throughout my open source project contributions, I've had to spend numerous hours editing README files which I could've spent developing instead. This paired with me often forgetting to change links, titles and sections made me look for a README generator.

Whilst alternative options existed, I struggled to find one that could suit my needs whilst being fast and easy to use, the ones I found were command-line based, only taking a limited input with the inability to go back on, as such I've built this, a README Generator!

With this open-source project, I hope to allow you to save as much time as it saved me, the benefits of this project are huge and here's why:

• Your time should be focused on creating something amazing. A project that solves a problem and helps others
• You shouldn't be doing the same tasks over and over like creating a README from scratch
• You should element DRY principles to the rest of your life 😄

Of course, no one template will serve all projects since your needs may be different. Whilst this template has served my needs, it may not serve yours so I'll be continuing to work on this to make a more "Universal" and "Flexible" ReadME Generator in the future. Feel free to suggest changes by opening a new issue, or if you want to implement your own, feel free to fork this repo and create a pull request.

Whilst I was the main developer of this project, this project couldn't of even started without the help of these open source projects, special thanks to:

• JavaScript
• VueJS

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

This program has no pre-requisites

1. Clone the repo

git clone https://github.com/ShaanCoding/ReadME-Generator.git

2. Open The index.HTML file

3. Have fun!

Coming Soon!

See the open issues for a list of proposed features (and known issues).

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

• If you have suggestions for adding or removing projects, feel free to open an issue to discuss it, or directly create a pull request after you edit the README.md file with necessary changes.
• Please make sure you check your spelling and grammar.
• Create individual PR for each suggestion.
• Please also read through the Code Of Conduct before posting your first idea as well.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Distributed under the MPL-2.0 License. See LICENSE for more information.

• Shaan Khan - Comp Sci Student - Shaan Khan - All Work

• ShaanCoding
• Othneil Drew
• ImgShields