Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update contributing.rst to reflect current practice? #330

Open
timgdavies opened this issue Jun 28, 2019 · 1 comment
Open

Update contributing.rst to reflect current practice? #330

timgdavies opened this issue Jun 28, 2019 · 1 comment

Comments

@timgdavies
Copy link

I wasn't sure where best to file this issue, as it applies across a couple of repositories (hence choosing SSOT...) - but builds on discussions that Kate was involved in during technical workshop in Copenhagen this week. It's offered as a low-priority suggestion.

During that workshop, we identified that some community members were not always clear about current technical team expectations and practices for handling issues, contributing to code, or opening/closing pull requests.

I noticed that the current Contributing.rst file in each repo (which gets displayed to anyone opening a new issue like this one (see below) doesn't describe the expectations and practices that were discussed in Copenhagen, and links to this page which I think is also outdated.

image

You may wish to consider updating the standard Contributing.rst file to fit current expectations and guidance to contributors.

I have found in past projects that adding Pull Request and Issue templates to repositories can also be helpful for guiding community inputs in a useful direction.

@samuele-mattiuzzo
Copy link
Contributor

@timgdavies thanks for the suggestion, I was actually looking into this before heading off on holidays and I'll resume it. I did try to add a "mock" version of it at organisation level, but it didn't replicate across repos! So essentially, WIP! As you noticed, the guidance page is out of dated and needs updating, we do have wording around contributing to our repos, they need a bit of tidying up and then replicated across the repos with an extra CoC as well to make sure everything (or as much as we can) is covered

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants