Natt5 / challenge11-professional-README-generator

A command-line tool to quickly create README.md files that look professional. Perfect for developers that want to improve the documentation for their GitHub repositories without having to spend more time formatting and creating standard sections.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Challenge 11: Professional README Generator

Table of Contents

Description

Professional README Generator is a command-line application that generates top-notch README.md files for GitHub projects. The user fills in sections such as Description, Usage, Licence, Installation, Contribution, Tests, Questions.

Motivation

The goal of this project is to make the process of producing polished README files for GitHub repositories quicker and simpler. Developers can spend more time working on their projects by automating this task.

Features

  • Interface with a command line for user interaction.
  • Creation of the README files with sections customised for the specifics of the project.
  • Badges added for licence details automatically.
  • Linking to the user's GitHub profile.
  • Creation of a table of contents with links that can be clicked and redirected to the named parts of the dcoument.

Technologies Used

Inquirer.js
JavaScript
GitHub
Markdown
Node.js
npm
Shields.io
Visual Studio Code

Contribution Guidelines

Please adhere to these guidelines in order to contribute to the Professional README Generator project:

Fork the repo.
Clone the fork.
Make a branch.
Make the necessary adjustments.
Check your modifications.
Ensure your modifications are committed.
Push to your fork.
Submit a pull request.

Testing Instructions

Take these actions to run the Professional README Generator tests:

Make sure you've used npm install to install all required dependencies.
Use npm test to execute any test scripts included in the project.
Make sure your contributions pass each test by looking over the test outputs for any mistakes or failed tests.

User Story

I want a README generator as a developer so that I can quickly and professionally write a README for a new project.

Installation and Usage

Make a local copy of the repository on your computer.
Open your terminal and navigate to the project directory.
To install the necessary dependencies, run npm install.
You only need to execute node index.js in your terminal and follow the instructions to use the Professional README Generator.
After you complete the questions, your project directory will have a README.md file.

A walkthrough video demo of the Professional Readme Generator

Sample of the app generated README file

Screenshot of the app generated README file

GitHub Repository

Link to the GitHub repository for the Professional README Generator

Credits

The following resources were instrumental in this project’s completion:

Badge generation via Shields.io

Coding Boot Camp: Professional README Guide

GitHub's list of licenses for the project

Inquirer package

Markdown Guide

Node.js guide

Node.js tutorials

License

License: MIT

This project is licensed under the MIT License.

Badges

GitHub repo

Made with Visual Studio Code

Questions

Please get in touch with me using the information below if you have any questions or need more details about the Professional README Generator project:

GitHub Profile: Natt5
Email Address: Contact me

Your contributions and feedback are welcome!

About

A command-line tool to quickly create README.md files that look professional. Perfect for developers that want to improve the documentation for their GitHub repositories without having to spend more time formatting and creating standard sections.

License:MIT License


Languages

Language:JavaScript 100.0%