evergreen-docs:github-workflow
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
evergreen-docs:github-workflow [2014/10/03 11:58] – rjs7 | evergreen-docs:github-workflow [2024/07/10 08:03] (current) – Windows cmd doesn't let you separate commands with a semicolon sandbergja | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Docs GitHub Workflow ====== | ====== Docs GitHub Workflow ====== | ||
- | When someone [[evergreen-docs: | + | When someone [[evergreen-docs: |
- | | + | ===== Reviewing the pull request ===== |
+ | |||
+ | | ||
+ | - Open the pull request in the Github web interface. | ||
+ | - Open the Files Changed tab | ||
+ | - Make sure the asciidoc changes look good | ||
+ | - Open the Checks tab | ||
+ | - Expand the " | ||
+ | - Open the Artifacts menu and select built-docs | ||
+ | - Unzip the artifact and open it in your browser. | ||
+ | - Check to make sure that the expected changes look good in the built docs, and that there are no unexpected changes. | ||
+ | |||
+ | |||
+ | ===== Committing the changes ===== | ||
+ | |||
+ | If everything looks good: | ||
+ | |||
+ | - On the commits tab, note how many new commits are in the pull request -- you will need this information later. | ||
+ | - In your terminal, if you haven' | ||
- '' | - '' | ||
- | - Update your local master | + | - Update your local main branch to reflect any changes from " |
- | - '' | + | - '' |
- Fetch the pull request branch into a new local branch | - Fetch the pull request branch into a new local branch | ||
- '' | - '' | ||
- | - Checkout | + | - Cherry pick the relevant commits into your local copy of the main branch. |
- | - '' | + | - If only one commit: |
- | - Rebase | + | - If more than one: '' |
- | - '' | + | - The '' |
- | - Test build the changed AsciiDoc file | + | - If you need to squash commits: |
- | | + | |
- | | + | |
- | | + | |
+ | | ||
+ | | ||
+ | | ||
- Make any corrections (via additional commits, if needed) | - Make any corrections (via additional commits, if needed) | ||
- | - Use interactive rebase to add the commits to your local master, adding your sign-off | + | - Use '' |
- | - '' | + | - Make sure that the commit message begins with " |
- | * Include | + | - Make sure the commit message includes |
- | | + | |
- | * Out-dent the sign-off line (if present) | + | - (If the GitHub author does not match the author' |
- | * Add newlines to long commit messages, making lines about 72 characters long | + | - When you are confident your local main branch is ready: '' |
- | * (If the GitHub author does not match the author' | + | |
- | - When you are confident your commits are ready: '' | + | |
- Backport to previous EG versions as appropriate | - Backport to previous EG versions as appropriate | ||
- | | + | |
- | - Close pull request on GitHub | + | - '' |
+ | - If one commit: '' | ||
+ | - If more than one: '' | ||
+ | - '' | ||
+ | - Go back to the pull request on Github' |
evergreen-docs/github-workflow.1412351917.txt.gz · Last modified: 2022/02/10 13:34 (external edit)