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.
- Clone this repository
- Open the terminal, cd to the project folder and run
npm install - Open the
generate.jsfile and update it with your project information - Run
npm run gento 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:
const specs = {
project: {
name: "XYZ",
defaultBranch: "main",
repoUrl: "https://github.com/user/project-slug/",
docsUrl: "https://github.com/user/project-slug/blob/main/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,
},
};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. 🤩
contributing-gen is released under the MIT License.
For the templates we have looked at several open source projects: