diff --git a/docs/cli-usage.rst b/docs/cli-usage.rst
index d66d73849..a2bbbd259 100644
--- a/docs/cli-usage.rst
+++ b/docs/cli-usage.rst
@@ -98,13 +98,17 @@ server, with very limited permissions.
    * - ``url``
      - URL for the GitLab server
    * - ``private_token``
-     - Your user token. Login/password is not supported. Refer to `the official
-       documentation`_pat to learn how to obtain a token.
+     - Your user token. Login/password is not supported. Refer to `the
+       official documentation
+       <https://docs.gitlab.com/ce/user/profile/personal_access_tokens.html>`__
+       to learn how to obtain a token.
    * - ``oauth_token``
      - An Oauth token for authentication. The Gitlab server must be configured
        to support this authentication method.
    * - ``job_token``
-     - Your job token. See `the official  documentation`_job-token to learn how to obtain a token.
+     - Your job token. See `the official documentation
+       <https://docs.gitlab.com/ce/api/jobs.html#get-job-artifacts>`__
+       to learn how to obtain a token.
    * - ``api_version``
      - GitLab API version to use. Only ``4`` is available since 1.5.0.
    * - ``http_username``
@@ -112,9 +116,6 @@ server, with very limited permissions.
    * - ``http_password``
      - Password for optional HTTP authentication
 
-.. _pat: https://docs.gitlab.com/ce/user/profile/personal_access_tokens.html
-.. _job-token: https://docs.gitlab.com/ce/api/jobs.html#get-job-artifacts
-
 CLI
 ===