The what, why, and how:
Every good project needs a quality README with information about the app - what the app is for, how to use the app, how to install it, how to report issues, and how to make contributions so that other developers are more likely to use and contribute to the success of the project.
This is a command-line application that runs with Node.js that dynamically generates a README.md file based on input about your project. Check out the ExampleREADME.md in this repo as an example.
Steps required to install project and how to get the development environment running:
To generate your own README, first run npm install in order to install the following npm package dependencies as specified in the package.json:
inquirerthat will prompt you for your inputs from the command lineaxiosto fetch your info from the GitHub API
The application itself can be invoked with node index.js.
Instructions and examples for use:
When you run node index.js, the application uses the inquirer package to prompt you in the command line with a series of questions about your GitHub and about your project.
The application then takes your responses and uses axios to fetch your GitHub profile from the GitHub API, including your GitHub profile picture (avatar) and email.
From there, the application will generate markdown and a table of contents for the README conditionally based on your responses to the Inquirer prompts (so, if you don't answer the optional questions, such as Installation, an Installation section will not be included in your README). The README will also include badges for your GitHub repo.
Finally, fs.writeFile is used to generate your project's README.md file. Check out the ExampleREADME.md in this repo as an example. The lorem ipsum is generated thanks to Social Good Ipsum.
The application utilizes modularization by separating the GitHub API call and generation of the markdown into separate modules: api.js and generateMarkdown.js, respectively, inside the utils folder.
The application also utilizes, as much as possible, syntax and paradigms introduced in ES6 and beyond, including arrow functions, const, let, template literals, and async/await to handle the inquirer, axios, and fs.writeFile promises.
MIT License
If you utilize this app to generate a README for your project, I'd love to see. Feel free to contact me with examples or any questions via the information below:
GitHub: @connietran-dev
Email: connietrandev@gmail.com