Please see USAGE.md
for information on how to use the Manubot for writing the manuscript.
Below you'll find information on the contribution workflow for Deep Rules.
We use issues for discussion of papers, section outlines, and other structural components of the paper.
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.
To mark a pull request as a work in progress, use WIP
, work in progress
, or 🚧
somewhere in the title to automatically prevent merging.
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 by someone other than the author and the maintainer. If there is any unaddressed criticism or disapproval, a repository maintainer will determine how to proceed and may wait for additional feedback.
- Contributor creates a new pull request (optionally with
[WIP]
in the title to indicate work in progress) - Pull request author removes [
WIP
] to indicate it is ready for review - Maintainer suggests edits and approves the pull request after all changes are made
- Second maintainer approves and merges the pull request
- If you have met the requirements for all of the columns in
contributors.md
(except for final approval), PR your information tocontent/metadata.yaml
. Note: authorship order incontent/metadata.yaml
reflects chronological order, not final authorship order. Final authorship order will be determined when we are finished with our draft and it is ready for submission.