diff --git a/docs/src/guides/update-workflow.rst b/docs/src/guides/update-workflow.rst
index 27365acbe..6ef3bb9cb 100644
--- a/docs/src/guides/update-workflow.rst
+++ b/docs/src/guides/update-workflow.rst
@@ -5,7 +5,7 @@ We update the official workflow regularly with:
 
 -  `curated metadata including latitudes/longitudes, clade annotations, and low quality sequences <https://github.com/nextstrain/ncov/commits/master>`__
 -  bug fixes
--  `new features <../reference/change_log>`__
+-  :doc:`new features <../reference/change_log>`
 
 Update your local copy of the workflow, to benefit from these changes.
 
@@ -21,7 +21,7 @@ Update your local copy of the workflow, to benefit from these changes.
    # and then replay your local changes on top of those incoming changes.
    git pull --rebase origin master
 
-Alternately, download a specific version of the workflow that you know works for you. We create new `releases of the workflow <https://github.com/nextstrain/ncov/releases/>`__ any time we introduce breaking changes, so you can choose when to update based on `what has changed <../reference/change_log>`__.
+Alternately, download a specific version of the workflow that you know works for you. We create new `releases of the workflow <https://github.com/nextstrain/ncov/releases/>`__ any time we introduce breaking changes, so you can choose when to update based on :doc:`what has changed <../reference/change_log>`.
 
 .. code:: bash