Fix URL formatting in the docs

Author: xylar

conda_package/docs/authors.rst

@@ -23,5 +23,5 @@ Contributors
 * Phillip J. Wolfram
 * Tong Zhang
 
-For a list of all the contributions:
-https://github.com/MPAS-Dev/MPAS-Tools/graphs/contributors
+For a list of all contributions, see the
+`contributors graph <https://github.com/MPAS-Dev/MPAS-Tools/graphs/contributors>`_.

conda_package/docs/building_docs.rst

@@ -26,4 +26,4 @@ To preview the documentation locally, open the ``index.html`` file in the
   cd _build/html
   python -m http.server 8000
 
-Then, open http://0.0.0.0:8000/master/ in your browser.
+Then, open `<http://0.0.0.0:8000/master/>`_ in your browser.

conda_package/docs/making_changes.rst

@@ -21,9 +21,9 @@ things like whitespace at the end of lines.
 The first time you set up the ``mpas_tools_dev`` environment, you will need to set up
 ``pre-commit``. This is done by running:
 
-```bash
-pre-commit install
-```
+.. code-block:: bash
+
+  pre-commit install
 
 You only need to do this once when you create the ``mpas_tools_dev``
 environment. If you create a new version of ``mpas_tools_dev``, then you will
@@ -43,9 +43,9 @@ PEP8 compliance, as well as sort, check and format imports,
 f-strings, and `mypy <https://mypy-lang.org/>` to check for consistent variable
 types. An example error might be:
 
-```bash
-example.py:77:1: E302 expected 2 blank lines, found 1
-```
+.. code-block:: bash
+
+  example.py:77:1: E302 expected 2 blank lines, found 1
 
 For this example, we would just add an additional blank line after line 77 and
 try the commit again to make sure we've resolved the issue.

conda_package/docs/releasing.rst

@@ -17,8 +17,8 @@ Version Bump and Dependency Updates
      - ``conda_package/mpas_tools/__init__.py``
      - ``conda_package/recipe/recipe.yaml``
 
-   - Make sure the version follows semantic versioning (see
-     https://semver.org/).
+   - Make sure the version follows
+     `semantic versioning <https://semver.org/>`_.
      For release candidates, use versions like ``1.3.0rc1`` (no ``v`` prefix).
 
 2. **Check and Update Dependencies**
@@ -38,7 +38,7 @@ Version Bump and Dependency Updates
    - The dependencies in ``recipe.yaml`` are the ones that will be used for the
      released package on conda-forge. The dependencies in ``pyproject.toml``
      are for PyPI and should be kept in sync as much as possible but are only
-     there as a sanity check when we run ```pip check``. The ``dev-spec.txt``
+     there as a sanity check when we run ``pip check``. The ``dev-spec.txt``
      file should include all dependencies needed for development and testing,
      and ``pixi.toml`` should remain equivalent for pixi users.
 
@@ -100,8 +100,7 @@ Tagging and Publishing a Release Candidate
      - Update dependencies if needed
 
    - Commit, push to a new branch, and open a PR **against the ``dev`` branch**
-     of the feedstock:
-     https://github.com/conda-forge/mpas_tools-feedstock
+     of the `mpas_tools-feedstock <https://github.com/conda-forge/mpas_tools-feedstock>`_.
 
    - Follow any instructions in the PR template and merge once approved
 
@@ -112,7 +111,7 @@ Publishing a Stable Release
 
    - For stable releases, create a GitHub release page as follows:
 
-     - Go to https://github.com/MPAS-Dev/MPAS-Tools/releases
+     - Go to `the GitHub releases page <https://github.com/MPAS-Dev/MPAS-Tools/releases>`_
 
      - Click "Draft a new release"
 
@@ -127,8 +126,8 @@ Publishing a Stable Release
 
 7. **Updating the conda-forge Feedstock for a Stable Release**
 
-   - Wait for the ``regro-cf-autotick-bot`` to open a PR at:
-     https://github.com/conda-forge/mpas_tools-feedstock
+   - Wait for the ``regro-cf-autotick-bot`` to open a PR at the
+     `mpas_tools-feedstock repository <https://github.com/conda-forge/mpas_tools-feedstock>`_.
 
    - This may take several hours to a day.
 
@@ -137,7 +136,8 @@ Publishing a Stable Release
      - Merge once CI checks pass
 
    **Note:** If you are impatient, you can accelerate this process by creating
-   a bot issue at: https://github.com/conda-forge/mpas_tools-feedstock/issues
+   a bot issue at the
+   `mpas_tools-feedstock issues page <https://github.com/conda-forge/mpas_tools-feedstock/issues>`_
    with the subject ``@conda-forge-admin, please update version``.  This
    will open a new PR with the version within a few minutes.
 

conda_package/docs/visualization.rst

@@ -49,7 +49,7 @@ centers to triangle nodes.  ``dsTris`` includes variables ``triCellIndices``,
 the cell that each triangle is part of; ``nodeCellIndices`` and
 ``nodeCellWeights``, the indices and weights used to interpolate from MPAS cell
 centers to triangle nodes; Cartesian coordinates ``xNode``, ``yNode``, and
-``zNode``; and ``lonNode``` and ``latNode`` in radians. ``lonNode`` is
+``zNode``; and ``lonNode`` and ``latNode`` in radians. ``lonNode`` is
 guaranteed to be within 180 degrees of the cell center corresponding to
 ``triCellIndices``.  Nodes always have a counterclockwise winding.