History

Merge pull request #1385 from simon04/maintainers-pr

docs/maintainers: clarify deployment workflow

Oliver Eyton-Williams committed 5 years ago

Commit b02da2b2 parents e6baef3 88c44a71 file · +1 −1Browse files

Showing the changes to docs (1 of 1 file). Show all

Unified · Split

docs/maintainers.md+1−1
@@ -6,7 +6,7 @@ This document is intended for [DevDocs maintainers](#list-of-maintainers). · 5 unmodified lines
6 6
7- PRs should be approved by at least one maintainer before being merged.7- PRs should be approved by at least one maintainer before being merged.
8 8
9- PRs that add or update documentations should always be merged locally, and the app deployed, before the merge is pushed to GitHub.9- PRs that add or update documentations should always be built and tested locally, and the doc files uploaded by the `thor docs:upload` command, before the PR is merged on GitHub.
10 10
11 This workflow is required because there is a dependency between the local and production environments. The `thor docs:download` command downloads documentations from production files uploaded by the `thor docs:upload` command. If a PR adding a new documentation is merged and pushed to GitHub before the files have been uploaded to production, the `thor docs:download` will fail for the new documentation and the docker container will not build properly until the new documentation is deployed to production.11 This workflow is required because there is a dependency between the local and production environments. The `thor docs:download` command downloads documentations from production files uploaded by the `thor docs:upload` command. If a PR adding a new documentation is merged and pushed to GitHub before the files have been uploaded to production, the `thor docs:download` will fail for the new documentation and the docker container will not build properly until the new documentation is deployed to production.
12 12