We use issues for discussion of papers, section outlines, and other structural components of the paper. We suggest that when you start your work on an area, you first file an issue to make sure your contributions will not conflict with any simultaneous edits. Start the issue title with "[WIP]" and assign the label "workinprogress".
Contributions to the article operate on a pull request model. We expect participants to actively review pull requests. We'd love to have you ask questions, clarify points, and jump in and edit the text.
What qualifies as authorship? We use the ICMJE Guidelines. We expect authors to contribute to the overall design by participating in issues, to contribute to the text by contributing sections and/or revisions to sections through pull requests. It is important to note that, for authorship, these should be substantial intellectual contributions.
All pull requests will undergo peer review. Participants in this project should review proposed changes (pull requests), which can be done using GitHub's review interface. They should suggest modifications or, potentially, directly edit the pull request to make suggested changes. As a reviewer, it's helpful to note the type of review you performed: did you read cited literature, look over the text in detail, or are you just supporting the concept?
Before a repository maintainer merges a pull request, there must be at least one affirmative review. If there is any unaddressed criticism or disapproval, a repository maintainer will determine how to proceed and may wait for additional feedback.
Please see USAGE.md for information on how to use the Manubot for writing the manuscript. Contributions to the main content directory will be automatically compiled into the live HTML and PDF versions of the manuscript.