contributing-gen

A configurable CONTRIBUTING.md generator - The guideline to communicate how people should contribute to your project.

Usage no npm install needed!

<script type="module">
  import contributingGen from 'https://cdn.skypack.dev/contributing-gen';
</script>

README

Welcome to contributing-gen

A configurable CONTRIBUTING.md generator - The guideline to communicate how people should contribute to your project.

Generate it directly in your browser with the web frontend (contributing-gen-web). 🎉

The generated artifacts should serve as basis, adviser and inspiration. We do not guarantee completeness, but a good starting point for a well-structured guide.

Getting Started

  • Clone this repository to your local machine
  • Open your favored terminal within the project folder and run npm install
  • Open the generate.js file and insert your information
  • After you are done, get back to the terminal and run npm run gen

The files have now been generated and you can copy them into your project repository. And don't forget to mention them in your readme.

In the following listing you see the specification, which you have to fill with your information:

const specs = {
    project: {
        name: "Our Cool Project",
        slug: "our-cool-project",
        repoUrl: "https://github.com/user/slug/",
        docsUrl: "https://github.com/user/slug/blob/master/README.md",
    },
    contributing: {
        generate: true,
        emailSensitiveBugs: "security@example.com",
    },
    codeOfConduct: {
        generate: true,
        // enforcement email must not be omitted if 'generate' is true
        enforcementEmail: "email@example.com",
        // additional info about how the code of conduct will be enforced
        enforcementGuidelines: false,
    },
}

Contributing

Although this project should serve as a good example, we don't have an extra guideline for contributions, since the project has a small scope without any programming. Nevertheless, anyone who wants to participate, in whatever form, must follow our Code of Conduct.

Everyone who has ideas and suggestions for improvement is encouraged to contribute. Be it with a simple issue or a pull request. Our goal is to create the best template for contribution guidelines, which helps every open source developer to create an individual guide. It should be made clear to project owners how comprehensible and simple guidelines are structured and how to encourage the community to participate in the project. And don't hesitate, even if it is just a small typo you have spotted.

The community looks forward to your contributions. 🤩

License

contributing-gen is released under the MIT License.

Acknowledgment

For the templates we have looked at several open source projects as examples: