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/08/29 12:34] – yboston | 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 ===== |
- | - '' | + | |
- | - Test build the changed AsciiDoc file | + | - [[https:// |
- | | + | - 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't yet, add the main Evergreen repo (on GitHub) as a remote (make sure you're in the directory you're working on before running command) | ||
+ | | ||
+ | | ||
+ | | ||
+ | - Fetch the pull request branch into a new local branch | ||
+ | - '' | ||
+ | - Cherry pick the relevant commits into your local copy of the main branch. | ||
+ | | ||
+ | | ||
+ | - The '' | ||
+ | - If you need to squash commits: | ||
+ | | ||
+ | - Your text editor will open and should show both of the commits, for example: | ||
+ | - '' | ||
+ | - '' | ||
+ | - Change the word '' | ||
+ | - 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) | ||
- | - Sign off on each commit: | + | - Use '' |
- | | + | |
- | * Prepend the relevant Launchpad bug number to the commit title | + | |
- | * Example: " | + | |
- | * Out-dent the sign-off line (if present) | + | |
- | * Add newlines to long commit messages, making lines about 72 characters long | + | - When you are confident your local main branch is ready: '' |
- | - 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.1409330046.txt.gz · Last modified: 2022/02/10 13:34 (external edit)