Welcome to contributing-gen

A CONTRIBUTING.md generator - A 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
• Open the terminal, cd to the project folder and run npm install
• Open the generate.js file and update it with your project information
• Run npm run gen to generate new files

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:

1const specs = {
2  project: {
3    name: "XYZ",
4    defaultBranch: "main",
5    repoUrl: "https://github.com/user/project-slug/",
6    docsUrl: "https://github.com/user/project-slug/blob/main/README.md",
7  },
8  contributing: {
9    generate: true,
10    emailSensitiveBugs: "security@example.com",
11  },
12  codeOfConduct: {
13    generate: true,
14    // enforcement email must not be omitted if 'generate' is true
15    enforcementEmail: "email@example.com",
16    // additional info about how the code of conduct will be enforced
17    enforcementGuidelines: false,
18  },
19};

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:

• Ruby on Rails
• Open Government
• Atom
• weallcontribute
• generate-contributing
• contributing-template
• idiomatic-contributing
• Celery
• Ember
• Bootstrap