From d88bce53d207b2ba6b2fcc90bd750950771803d8 Mon Sep 17 00:00:00 2001
From: John Shepherd <john@openrobotics.org>
Date: Tue, 19 Jan 2021 22:08:27 -0800
Subject: [PATCH] move docs and testing

Signed-off-by: John Shepherd <john@openrobotics.org>
---
 README.md            | 41 ++++++++++++++++++++++++++++++++++++--
 tutorials/install.md | 47 ++++----------------------------------------
 2 files changed, 43 insertions(+), 45 deletions(-)

diff --git a/README.md b/README.md
index 7d7aa80a..36fb3042 100644
--- a/README.md
+++ b/README.md
@@ -98,11 +98,48 @@ This library is used internally by the ignition projects. See other ignition pro
 
 # Documentation
 
-Documentation for `ignition-cmake` can be found within the source code, and also in the [MIGRATION.md guide](https://github.com/ignitionrobotics/ign-cmake/blob/master/MIGRATION.md).
+API documentation and tutorials can be accessed at
+[https://ignitionrobotics.org/libs/cmake](https://ignitionrobotics.org/libs/cmake)
+
+You can also generate the documentation from a clone of this repository by following these steps.
+
+1. You will need [Doxygen](http://www.doxygen.org/). On Ubuntu Doxygen can be installed using
+
+        sudo apt-get install doxygen
+
+2. Clone the repository
+
+        git clone https://github.com/ignitionrobotics/ign-cmake
+
+3. Configure and build the documentation.
+
+        cd ign-cmake
+        mkdir build
+        cd build
+        cmake ..
+        make doc
+
+4. View the documentation by running the following command from the `build` directory.
+
+        firefox doxygen/html/index.html
+
+**Note** Alternatively, documentation for `ignition-cmake` can be found within the source code, and also in the [MIGRATION.md guide](https://github.com/ignitionrobotics/ign-cmake/blob/master/MIGRATION.md).
 
 # Testing
 
-A fuller suite of tests in the `examples` directory can be enabled by building with `BUILDSYSTEM_TESTING` enabled.
+Follow these steps to run tests and static code analysis in your clone of this repository.
+
+1. Follow the [source install instruction](#source-install).
+
+2. Run tests.
+
+        make test
+
+3. Static code checker.
+
+        make codecheck
+
+Additionally, a fuller suite of tests in the `examples` directory can be enabled by building with `BUILDSYSTEM_TESTING` enabled.
 Tests can be run by building the `test` target. From your build directory you can run:
 
 ```
diff --git a/tutorials/install.md b/tutorials/install.md
index 5c54741c..e5562185 100644
--- a/tutorials/install.md
+++ b/tutorials/install.md
@@ -162,55 +162,16 @@ To find `condabin`, search for "Anaconda Prompt" in the search field near the Wi
         # Optionally, append `-b ign-cmake#` (replace # with a number) to check out a specific version
         git clone https://github.com/ignitionrobotics/ign-cmake.git
 
-1. Build. Tests do not build at this time, so we turn tests off.
+1. Build.
 
         cd ign-cmake
         mkdir build
         cd build
-        cmake .. -DBUILD_TESTING=OFF  # Optionally, -DCMAKE_INSTALL_PREFIX=path\to\install
+        cmake .. # Optionally, -DCMAKE_INSTALL_PREFIX=path\to\install
         cmake --build . --config Release
         cmake --install . --config Release
 
-# Documentation
+**Note** If you find that the build is failing due to failures in the `test` directory, then you may need to disable tests by adding `-DBUILD_TESTING=OFF` to the `cmake ..` command.
 
-API documentation and tutorials can be accessed at
-[https://ignitionrobotics.org/libs/cmake](https://ignitionrobotics.org/libs/cmake)
-
-You can also generate the documentation from a clone of this repository by following these steps.
-
-1. You will need [Doxygen](http://www.doxygen.org/). On Ubuntu Doxygen can be installed using
-
-        sudo apt-get install doxygen
-
-2. Clone the repository
-
-        git clone https://github.com/ignitionrobotics/ign-cmake
-
-3. Configure and build the documentation.
-
-        cd ign-cmake
-        mkdir build
-        cd build
-        cmake ..
-        make doc
-
-4. View the documentation by running the following command from the `build` directory.
-
-        firefox doxygen/html/index.html
-
-# Testing
-
-Follow these steps to run tests and static code analysis in your clone of this repository.
-
-1. Follow the [source install instruction](#source-install).
-
-2. Run tests.
-
-        make test
-
-3. Static code checker.
-
-        make codecheck
-
-See the [Writing Tests section of the contributor cmakede](https://ignitionrobotics.org/docs/all/contributing#writing-tests) for help creating or modifying tests.
+See the [Writing Tests section of the ign-cmake contributor documentation](https://ignitionrobotics.org/docs/all/contributing#writing-tests) for help creating or modifying tests.