Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document process of deploying documentation updates #58

Open
eecavanna opened this issue Apr 19, 2024 · 1 comment
Open

Document process of deploying documentation updates #58

eecavanna opened this issue Apr 19, 2024 · 1 comment
Labels
documentation Improvements or additions to documentation

Comments

@eecavanna
Copy link
Contributor

This PR is about how we get from "we've made changes within the repo" to "our documentation website (currently Read The Docs) reflects those changes."

For reference, this other PR is about editing the content of the repo: #8

@eecavanna eecavanna added the documentation Improvements or additions to documentation label Apr 19, 2024
@eecavanna
Copy link
Contributor Author

Also, document the process of deploying from non-main branches to the dev-nmdc-documentation website.

I think there are specific branches that the readthedocs.org website is aware of (one of which branches is named dev) that, if we merge code into those, we can use the readthedocs.org dashboard to make a build from that branch. I didn't find a way to get the readthedocs.org dashboard to see newly-created branches; so, I assume the current list of branches was defined at the time when the readthedocs.org project was first created (maybe readthedocs.org did a big pull of branch names at that time).

So, one workflow for deploying from a non-main branch to the dev-nmdc-documentation website could be:

  1. Merge the changes into the dev branch (or another one of the branches that readthedocs.org already "sees")
  2. Use the readthedocs.org dashboard to activate that branch as a source (if not already active)
  3. Use the readthedocs.org dashboard to create a build from that source

    image

  4. Visit the resulting website; for example (note the final path segment in the URL):

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

1 participant