doc-fix: fix links in benefits of using dart

fixes #829
Added anchors to linked sections
Fixed typos in guide/contributors-guide.rst

Author: hkershaw-brown

guide/adding-your-observations-to-dart.rst

@@ -1,3 +1,5 @@
+.. _adding-your-observations-to-dart:
+
 Adding your observations to DART
 ================================
 

guide/benefits-of-using-dart.rst

@@ -34,32 +34,31 @@ Here are some of the many benefits of using DART:
    system provided that you maintain the license and copyright information. Of
    course, we also ask that you credit DART in your publications, and kindly ask
    that you contribute your modifications so that other users may benefit. See
-   `How should I cite DART? <#citeDart>`__ and `How can I contribute to
-   DART? <#ContributeToDart>`__ for more information.
+   :ref:`How should I cite DART?<citeDART>` and :ref:`How can I contribute to
+   DART? <contributors-guide>` for more information.
 2. DART is **fully parallel and carefully engineered** to run on systems ranging
    from single-core research computers to the top performing multicore
    supercomputers in the world. Writing scalable parallel code is arguably the
    most difficult and time-consuming task in scientific computing today, but
    DART has already carefully implemented and tested this project, and the code
    is available for you to use out-of-the-box. For more information on how DART
-   was written (and continues to be developed), see `DART’s design
-   philosophy <#dartDesign>`__.
+   was written (and continues to be developed), see :ref:`dart-design-philosophy`.
 3. DART contains **numerous tools that accelerate getting started** on both
    research and “real-world” problems. Multiple rigorously tested inflation,
    localization, perturbation, and other auxiliary data assimilation algorithms
-   are available for immediate use and testing. See `Important capabilities of
-   DART <#dartCapabilities>`__ for more information.
+   are available for immediate use and testing. See :ref:`important-capabilities-dart`
+   for more information.
 4. DART **makes adding a new model straightforward**. A new model only needs to
    implement a list of (at most) 18 core functions or use the default behavior
-   if applicable to take advantage of DART’s mature and robust DA algorithms. A
+   if applicable to take advantage of DART's mature and robust DA algorithms. A
    basic data assimilation system for a large model can be built in
    person-weeks, and comprehensive systems have been built in a few months. See
-   `How do I run DART with my model? <#RunWithMyModel>`__ for more information.
+   :ref:`Using new models` for more information.
 5. DART **makes it easy to add new observations** in order to test their
    potential beneficial impact. Incorporating new observation types only
    requires creating a forward operator that computes the expected value of an
-   observation given a model’s state. See `How do I add my observations to
-   DART? <#RunWithMyObs>`__ for more information.
+   observation given a model's state. See :ref:`How do I add my observations to
+   DART? <adding-your-observations-to-dart>` for more information.
 6. DART **can be used to test new DA algorithms**. Many such algorithms have
    been successfully implemented, tested, and published using DART. This is not
    covered in this getting started guide as this is an “advanced user”

guide/contributors-guide.rst

@@ -1,3 +1,5 @@
+.. _contributors-guide:
+
 Contributors' guide
 ===================
 
@@ -15,10 +17,10 @@ All of the source code is hosted in the `DART GitHub repository
 <https://github.com/NCAR/DART>`__.
 
 Before you start developing, you should be familiar with the `GitHub
-workflow <https://guides.github.com/introduction/flow/>`_. The GitHub worflow 
+workflow <https://guides.github.com/introduction/flow/>`_. The GitHub workflow 
 involves:
 
-1. Creating a *fork* of the DART project. A fork is a publically visible copy
+1. Creating a *fork* of the DART project. A fork is a publicly visible copy
    of the repository that is stored in your GitHub account.
 2. Creating a *branch* for your feature with an appropriate name for your
    project, and when you are finished with your changes you can commit them

guide/dart-design-philosophy.rst

@@ -1,3 +1,5 @@
+.. _dart-design-philosophy:
+
 DART’s design philosophy
 ========================
 

guide/important-capabilities-dart.rst

@@ -1,3 +1,5 @@
+.. _important-capabilities-dart:
+
 Important capabilities of DART
 ==============================
 

index.rst

@@ -241,6 +241,8 @@ Download the appropriate tar file and untar it into your DART repository. Ignore
 any warnings about ``tar: Ignoring unknown extended header keyword``.
 
 
+.. _citeDART:
+
 Citing DART
 -----------