Page History

...

1. Log into https://readthedocs.com/dashboard/ and send a user request to join the "jointcenterforsatellitedataassimilation” team. You can follow this URL to the correct page to send a user request email.
2. The new user will receive an email. They should follow the link and set up an account. It is best to use your UCAR email.
3. If you need to add the new user as an Owner, navigate to https://readthedocs.com/organizations/jointcenterforsatellitedataassimilation/owners/ and add their email address or username used to the "Add Owner" section.

Updating the credit card

Occasionally our JCSDA administrator might need to update the card that pays for Read the Docs. In the past an Owner will give them access to their account in order the change the credit card information. Typically this is done with a UCAR P-card. To manage the subscription and update the credit card, navigate to https://readthedocs.com/organizations/jointcenterforsatellitedataassimilation/subscription/. 

...

1. Log into Read the Docs and navigate to the jedi-docs project page. 
2. Click on "versions" in the top menu bar. If you have difficulty finding this option try this url. 
3. Scroll down to "Activate a version" and type in the new release tag (ie 9.0.0). 

Configuring ReadTheDocs and GitHub for proper rendering of the documentation in our private jedi-docs repo

When a PR is submitted or updated in the jedi-docs repo, ReadTheDocs will render the documentation and a link to that rendering is provided in the PR check on GitHub.

Image Added

Clicking on the "Details" button in the checks list takes the user to the newly rendered documentation. This is a great feature for the submitter and reviewers of the PR. However, to configure this with a private repo (i.e., our JCSDA-internal/jedi-docs repo) requires a workaround to help mitigate security risks.

Here are instructions on how to configure this capability.

• readthedocs.com uses git@github.com/path/to/repo for private repositories, and a deploy key in the repo that is the public SSH key exported by readthedocs.com
• git-lfs "doesn't do" authentication via ssh, only https so they way to configure this is - to avoid any security risks:

1. 1. Create a new Github user jedi-docs-reader
   2. Create a Github token for the reader
   3. Give this user read-only access to jcsda-internal/jedi-docs only - NOTHING else
   4. Reconfigure the readthedocs build project to use https://jedi-docs-reader:XXXXXX@github.com/JCSDA-internal/jedi-docs.git
      1. Replace the "XXXXXX" in the URL above with the GitHub token that was generated in step "b" above.

• The github token of this jedi-docs-reader will be in the build logs, therefore the need for a separate user with minimal permissions.