User Tools

Site Tools


evergreen-docs:github-workflow

Docs GitHub Workflow

When someone submits a change via GitHub, an Evergreen developer should follow these steps to review it:

  1. Note how many new commits are in the pull request – you will need this information later.
  2. If you haven't yet, add the main Evergreen repo (on GitHub) as a remote
    1. git remote add github-evergreen https://github.com/evergreen-library-system/Evergreen.git
  3. Update your local master branch to reflect any changes from "origin"
    1. git checkout master; git fetch origin; git pull origin master
  4. Fetch the pull request branch into a new local branch
    1. git fetch github-evergreen pull/[PULL_REQ_NUMBER]/head:[BRANCHNAME]
  5. Cherry pick the relevant commits into your local copy of the master branch.
    1. If only one commit: git cherry-pick -s [BRANCHNAME]
    2. If more than one: git cherry-pick -s [BRANCHNAME]~[Number of commits]..[BRANCHNAME] --edit (for example, if you are bringing in two commits from the survey-docs branch, run git cherry-pick survey-docs~2..survey-docs) --edit
      1. The --edit flag will permit you to edit all commit messages as they come in.
  6. Test build the changed AsciiDoc file + the nav.adoc file(s) that include it
    1. perl ./generate_docs.pl --base-url http://examplesite.org/prod
    2. Check to see if there are any images posted to the Github conversation that have not been committed yet. Add those to Evergreen/docs/modules/<module_name>/assets/images/media/
    3. Also look for other AsciiDoc warnings or errors
  7. Make any corrections (via additional commits, if needed)
  8. Use git log to make sure everything looks good.
    1. Make sure that the commit message begins with "Docs:"
    2. Make sure the commit message includes the relevant Launchpad bug number
      1. Example: "Resolves LP#1234567"
    3. (If the GitHub author does not match the author's identity in git.evergreen-ils.org, consider fixing it with git commit --amend --author="NAME <email>")
  9. When you are confident your local master branch is ready: git push origin master
  10. Backport to previous EG versions as appropriate
    1. git checkout rel_3_8 (where rel_3_8 is the branch for previous version)
    2. git pull (to get the most up-to-date version of the branch)
    3. If one commit: git cherry-pick master
    4. If more than one: git cherry-pick master~[Number of commits]..master
    5. git push
  11. Go back to the pull request on Github's site. Comment on the pull request to thank the contributor, then close the pull request.
evergreen-docs/github-workflow.txt · Last modified: 2021/07/29 11:51 by aneiman

© 2008-2017 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a member of Software Freedom Conservancy.