Learn more about these different git repos.
Other Git URLs
Put a text file with contributing guidelines in a specific path, boost visibility of guidelines across project
Every project has a different way of doing things or has their own preferences. Documenting these things are helpful for new contributors. A project can write their own contributing guidelines in a Markdown file today, but it's on the maintainer to make them more visible and for the user to go and find them.
Making contributing guidelines more visible in the UI encourages maintainers to write them (because there is a higher chance they will be seen) and also reduces the burden on maintainers if they write good guidelines for new contributors to follow.
I like GitHub's implementation. If you place a CONTRIBUTING.md file in the root directory or in a .github folder, this is a special path and the UI will offer suggestions in different places (e.g. filing a new issue or opening a pull request prompts you, "Did you already see the contributing guidelines?"). I would like to see something similar, except maybe a more platform-neutral vocabulary if I wanted to put it in a hidden directory.
CONTRIBUTING.md
.github
Supporting UI for this is key. I think adding prompts in the following places is a good idea, if a project adds contributing guidelines:
We already have something when opening new PRs: https://docs.pagure.org/pagure/usage/pr_custom_page.html Adding something when opening new tickets could be interesting.
I'm not entirely sure about adding them on the issues or PRs pages to be honest, but maybe.
Question: is it problematic if that file isn't in the sources but rather in the requests or tickets git repo as we are doing so far?
Metadata Update from @pingou: - Issue tagged with: RFE, UI
+1 and can be nice to have a CODE_OF CONDUCT.md
My motive for that is so guidelines are more visible and easily noticed, if a project maintainer takes the time to write them up.
It's difficult to accept new pull requests for these repositories. I prefer to place them in the sources repo so they are visible and accessible for someone browsing through the project.
Login to comment on this ticket.