Git Product home page Git Product logo

9-readme-generator's Introduction

Unit 09 Node.js and ES6+ Homework: Good README Generator

Create a command-line application that dynamically generates a README.md from a user's input. The application will be invoked with the following command:

node index.js

The user will be prompted for their GitHub username and other information pertaining to the project the README is for.

The README will be populated with the following:

  • At least one badge
  • Project title
  • Description
  • Table of Contents
  • Installation
  • Usage
  • License
  • Contributing
  • Tests
  • Questions
    • User GitHub profile picture
    • User GitHub email

Following the common templates for user stories, we can frame this challenge as follows:

AS A developer

I WANT a README generator

SO THAT I can easily put together a good README for a new project

Refer to the Good README guide.

Business Context

When creating an open source project on GitHub, it is important to have a quality README with information about the app--what is the app 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. A command-line application will allow for quick and easy generation of a project README to get started quickly. This will allow a project creator to spend more time working on finishing the project and less time creating a good README.

Minimum Requirements

  • Functional, deployed application.

  • GitHub repository with a unique name and a README describing project.

  • The generated README includes the following sections:

    • Title
    • Description
    • Table of Contents
    • Installation
    • Usage
    • License
    • Contributing
    • Tests
    • Questions
  • The generated README includes 1 badge that's specific to the repository.

GIVEN the developer has a GitHub profile and a repository

WHEN prompted for the developer's GitHub username and repo specific information

THEN a README for the repo is generated

Commit Early and Often

One of the most important skills to master as a web developer is version control. Building the habit of committing via Git is important for two reasons:

  • Your commit history is a signal to employers that you are actively working on projects and learning new skills.

  • Your commit history allows you to revert your code base in the event that you need to return to a previous state.

Follow these guidelines for committing:

  • Make single-purpose commits for related changes to ensure a clean, manageable history. If you are fixing two issues, make two commits.

  • Write descriptive, meaningful commit messages so that you and anyone else looking at your repository can easily understand its history.

  • Don't commit half-done work, for the sake of your collaborators (and your future self!).

  • Test your application before you commit to ensure functionality at every step in the development process.

We would like you to have more than 200 commits by graduation, so commit early and often!

Submission on BCS

You are required to submit the following:

  • A video demonstrating the entirety of the app's functionality

  • A generated README.md file for a project repo.

  • The URL of the GitHub repository

9-readme-generator's People

Contributors

anieto86 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.