Refreshing the jhDocs Theme

The assets in the jhDocs theme receive important enhancements and fixes over time, so you’ll want to update to the latest version on a regular basis.

Follow the steps below to update the jhDocs theme in an existing Hugo site:

• Navigate to your site’s GitHub repo.
• In the GitHub repo, click on the Actions tab at the top of the screen.
• In the Actions screen, you’ll see a list of workflows on the left.
• Click the workflow titled “Update jhDocs Theme”.

• On the right side of the screen, you’ll see a dropdown button titled “Run workflow”.
• Click that dropdown button, ensure that the “Use workflow from” selection is your main branch, then press the “Run workflow” button.

• Click the “Actions” tab at the top again to see a list of running workflows.
• You’ll soon see an “Update jhDocs Theme” job running in the list.
  • This workflow checks to see if there is a newer version of the jhDocs theme than the one used in your repo today.
• If a newer version of the jhDocs theme is available, this workflow will create a PR for the theme update.
• After the workflow completes, click the “Pull Requests” tab at top of the screen.
• If a new jhDocs theme was found by the theme update action:
  • You’ll see a PR titled “Update jhDocs Theme”.
  • Go into that PR and click the “Files changed” tab for the PR.
  • In the “Files changed” screen, press the “Review changes” dropdown button at the far right.
  • Click the “Approve” radio button in the popup, then click the “Submit review” button.
  • Click the “Conversation” tab for the PR.
  • The “Merge pull request” button should be enabled. Press that and merge the PR. This kicks off a new GitHub workflow action.
  • Click the “Actions” tab at the top again to see a list of running workflows.
  • You’ll see a new workflow action running for the merged PR.
  • Once that workflow action completes, your site should be on the latest version of the jhDocs theme.