GithubHelp home page GithubHelp logo

gregswindle / generator-make-readme Goto Github PK

View Code? Open in Web Editor NEW

This project forked from jeff-matthews/generator-make-readme

0.0 3.0 0.0 50 KB

A Yeoman generator for quickly creating standards-compliant READMEs for open source software projects

License: MIT License

JavaScript 100.00%

generator-make-readme's Introduction

generator-make-readme

standard-readme compliant

Quickly generate standards-compliant READMEs for open source software projects.

Overview

This Yeoman generator conforms to the standard-readme specification with some added customizations to comply with AffiniPay's supplemental README standards. It creates a minimally compliant standard README for your open source software project.

Table of Contents

Background

Github is an important platform for collaborative software development. It's also a channel for AffiniPay to share tools with our partner/developer community. We need to provide concise, accurate, and standardized documentation for all AffiniPay open source projects.

Standardizing our READMEs makes creating and maintaining them easier, promotes a better developer experience, and helps us earn trust within the partner/developer community.

An effective README thoroughly explains:

  • What a project does (with context)
  • What a project looks like in action
  • How to install it
  • How to use it (with working examples)
  • All API methods/functions

This project is a customized version of Richard Littauer's generator-standard-readme project, but it follows the same specification.

Installation

This generator requires node, npm, and yeoman.

You can install it by itself by running:

npm install --global generator-make-readme

With Yeoman

You can also install it as a standard Yeoman generator by installing yo:

npm install --global yo

Usage

$ make-readme

With yo:

yo make-readme

This will write a file (README.md) to the local directory after you follow the prompts in a terminal.

Fields to fill out

The make-readme generator prompts you for information to create a README outline that contains all optional and required sections. These sections contain placeholder text and examples that you must modify before publishing the README.

Prompts include the following:

  1. What is the name of your project? - Defaults to the name of the repo.
  2. Summarize your project in one sentence: - You can add more detail later in the Overview and/or Background sections (if necessary).
  3. Do you have a banner image? - Optional.
  4. Do you want a standard-readme compliant badge? - Optional.
  5. Do you want a TODO dropped where more badges should be? - Optional.
  6. Do you want to add a prioritized Security section to the top of the README? - Optional.
  7. Do you need a Configuration section? - Optional.
  8. Do you need a Background section? - Optional.
  9. Do you need an API section? - Optional.
  10. Are pull requests accepted? - If true, adds a Contribute section with default guidelines.
  11. Is an MIT license OK? - If false, enter the license type in the next prompt (e.g., ISC). Make sure to update the license file in the repo.
  12. Who is the license holder? - The default is AffiniPay LLC.

Contribute

Contributions in the form of GitHub pull requests are welcome. Please adhere to the following guidelines:

  • Before embarking on a significant change, please create an issue to discuss the proposed change and ensure that it is likely to be merged.
  • Follow the coding conventions used throughout the project, including 2-space indentation and no unnecessary semicolons. Many conventions are enforced using eslint.
  • Any contributions must be licensed under the MIT license.

License

MIT © AffiniPay LLC

generator-make-readme's People

Contributors

hackergrrl avatar hsanjuan avatar jeff-matthews avatar richardlitt avatar

Watchers

 avatar  avatar  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.