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 [2021/05/28 14:22] – fixing my syntax mistake sandbergja | evergreen-docs:github-workflow [2023/12/28 15:54] (current) – aneiman | ||
---|---|---|---|
Line 3: | Line 3: | ||
When someone [[evergreen-docs: | When someone [[evergreen-docs: | ||
- | | + | ===== Reviewing the pull request ===== |
- | - If you haven' | + | |
+ | | ||
+ | - 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 | ||
- '' | - '' | ||
- | - Cherry pick the relevant commits into your local copy of the master | + | - Cherry pick the relevant commits into your local copy of the main branch. |
- | - '' | + | - If only one commit: '' |
- | - Test build the changed AsciiDoc file + the nav.adoc file(s) that include it | + | - If more than one: '' |
- | - '' | + | - The '' |
- | - Check to see if there are any images posted to the Github conversation that have not been committed yet. Add those to '' | + | - If you need to squash commits: |
- | - Also look for other AsciiDoc warnings or errors | + | - From your local branch, enter '' |
+ | | ||
+ | - '' | ||
+ | - '' | ||
+ | - Change | ||
+ | - Check gitlog to ensure that you now have a single commit | ||
- Make any corrections (via additional commits, if needed) | - Make any corrections (via additional commits, if needed) | ||
- Use '' | - Use '' | ||
Line 22: | Line 44: | ||
- Example: " | - Example: " | ||
- (If the GitHub author does not match the author' | - (If the GitHub author does not match the author' | ||
- | - When you are confident your local master | + | - When you are confident your local main branch is ready: '' |
- Backport to previous EG versions as appropriate | - Backport to previous EG versions as appropriate | ||
- | - '' | + | - '' |
- | - '' | + | - '' |
- | - Email docs list and/or pull requester to say it is done (or with other feedback) | + | - If one commit: |
- | - Close pull request on GitHub | + | - If more than one: '' |
+ | - '' | ||
+ | - Go back to the pull request on Github' |
evergreen-docs/github-workflow.1622226127.txt.gz · Last modified: 2022/02/10 13:34 (external edit)