RosettaCommons / RosettaCommons/atomworks

Update Contributing docs page

Open
#44 0 comments 0 reactions 1 assignee View on GitHub

@rclune is already working on this.

Since Oct 23, 2025.

Dominant language
Python
Stars
446
Forks
52
PR merge metrics
No merged PRs in 30d

Description

  • Add information about docstring formatting (which style is needed for the API docs to work?)
  • Link to external resources about writing tests
  • Provide information about where tests should go in the repo and how/when they should get automatically run with the GitHub runners
  • "Keep commits as 'one logical unit.' (Easy to do in VSCode)" - this comment would be more useful with an example or a link to something that expands on this idea
  • Link to the PR checklist
  • Add a documentation section that tells contributors how to build the documentation locally, links out to Sphinx tutorials, etc.
  • Unclear what the 'Visual Aids' comic is trying to get across IMO
  • Update PR Hygiene section - folks should be creating PRs to merge with the staging branch, right?
  • How does one contact the maintainers? Who should be contacted?
  • Link to the README (bottom of this page)

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.