Fix doc refs

docs/build.sh

@@ -6,7 +6,7 @@
 
 REPORTDIR=_build/html/reports
 
-jupyter-book build -n --keep-going .
+jupyter-book build -nW --keep-going .
 RETVAL=$?
 if [ $RETVAL -ne 0 ]; then
     if [ -e $REPORTDIR ]; then

docs/demography.md

@@ -1536,7 +1536,7 @@ to facilitate interchange between simulators, as well as between
 demographic inference software and simulators.
 Demes models are typically written as a YAML file (see the
 {ref}`Demes tutorial <demes-spec:sec_tutorial>` for details), and loaded into Python
-using the [demes](demes:sec_introduction) library.
+using the {ref}`demes <demes:sec_introduction>` library.
 The {meth}`.Demography.from_demes` method converts a {class}`demes.Graph`
 object into a {class}`.Demography` object, and the {meth}`.Demography.to_demes`
 method does the opposite conversion.

docs/intro.md

@@ -22,8 +22,8 @@ available for learning about {program}`tskit` and {program}`msprime`:
 - The [tskit tutorials](https://tskit.dev/tutorials) site provides an
   introduction to the tree sequence format used by {program}`msprime`,
   as well as in-depth tutorials
-  on more [advanced {program}`msprime` topics](tutorials:sec_msprime) and
-  examples of how to [analyse](tutorials:sec_analysing_tree_sequences)
+  on more {ref}`advanced {program}`msprime` topics <tutorials:sec_msprime>` and
+  examples of how to {ref}`analyse <tutorials:sec_analysing_tree_sequences>`
   simulated {program}`tskit` tree sequences.
 
 - Our [Discussions board](https://github.com/tskit-dev/msprime/discussions)