DOC anchors and indices

docs/source/instrument/_configure_databroker.md

@@ -1,6 +1,10 @@
 # Setup your databroker catalog configuration
 
-The bluesky instrument uses a YAML file which describes the connection
+```{index} catalog; databroker
+```
+
+
+The bluesky *instrument* uses a YAML file which describes the connection
 with some location where data is stored, typically a MongoDB collection.
 This is called a catalog configuration file.
 

docs/source/instrument/install_new_instrument.rst

@@ -1,3 +1,5 @@
+.. index:: install; new instrument
+
 Install New Instrument
 ======================
 
@@ -7,6 +9,8 @@ Describes the steps to install a new bluesky instrument.
 
 .. warning:: In Linux, use the ``bash`` command shell. For more info see `what is bash? <https://bcda-aps.github.io/bluesky_training/reference/_FAQ.html#faq-bash>`__
 
+.. _checklist:
+
 Installation checklist
 --------------------------
 
@@ -31,7 +35,7 @@ Use the ``new_bluesky_instrument.py``
 `program <https://github.com/BCDA-APS/bluesky_training/blob/main/new_bluesky_instrument.py>`__
 to install a new bluesky instrument configuration from the online `APS
 Bluesky Training <https://github.com/BCDA-APS/bluesky_training>`__
-repository template. The program creates a new ``bluesky`` directory in
+repository :index:`template`. The program creates a new ``bluesky`` directory in
 the home directory. Use ``new_bluesky_instrument.py -h`` for usage
 information.