Update installation instructions

docs/source/contributing.rst

@@ -58,7 +58,7 @@ Installing a Development Version
       conda activate scico
 
 
-6. Navigate to the root of the cloned repository:
+6. Change directory to the root of the cloned repository:
 
    ::
 
@@ -107,28 +107,24 @@ Installing a Development Version
 Building Documentation
 ----------------------
 
-A local copy of the documentation can be built from the respository root directory by doing
+Before building the documentation, one must install the documentation specific dependencies by running
 
 ::
 
-  python setup.py build_sphinx
-
+   pip install -r docs_requirements.txt
 
-Alternatively:
+Then, a local copy of the documentation can be built from the respository root directory by running
 
-1. Navigate to the docs directory ``docs/``
-
-2. Install dependencies
+::
 
-   ::
+  python setup.py build_sphinx
 
-      pip install -r docs_requirements.txt
 
-3. Build documentation
+Alternatively, one can also build the documentation by running the following from the `docs/`` directory
 
-   ::
+::
 
-      make html
+   make html
 
 
 
@@ -223,7 +219,7 @@ scico-data repositories must be updated and kept in sync.
 
 1. Add the ``new_data.npz`` file to the ``scico/data`` directory.
 
-2. Navigate to the ``data`` directory and add/commit the new data file:
+2. Change directory to the ``data`` directory and add/commit the new data file:
 
    ::
 

docs/source/examples.rst

@@ -7,18 +7,19 @@ Usage Examples
    :maxdepth: 1
 
 .. _example_dependencies:
+
 Example Dependencies
-------------------------
+--------------------
 
-Some examples may use additional dependecies. These dependencies are listed in `examples_requirements.txt <https://github.com/lanl/scico/blob/main/examples/examples_requirements.txt>`_.
-Pip should be used to install these extra requirements except astra which should be installed via conda:
+Some examples use additional dependencies which are listed in `examples_requirements.txt <https://github.com/lanl/scico/blob/main/examples/examples_requirements.txt>`_.
+The additional requirements should be installed via pip, with the exception of astra-toolbox, which should be installed via conda:
 
    ::
 
       conda install -c astra-toolbox astra-toolbox
       pip install -r examples/examples_requirements.txt # Installs other example requirements
 
-The dependencies can also be installed one by one as required.
+The dependencies can also be installed individually as required.
 
 Organized by Application
 ------------------------

docs/source/install.rst

@@ -61,7 +61,7 @@ The instructions above install a CPU-only version of SCICO. To install a version
 Additional Dependencies
 -----------------------
 
-For installing dependencies related to the examples please see :ref:`example_notebooks`.
+For instructions on installing dependencies related to the examples please see :ref:`example_notebooks`.
 
 
 For Developers