From 5d06b66316d522ebc1ce323f18bb2ba95507e8b6 Mon Sep 17 00:00:00 2001
From: Mateusz Pusz <mateusz.pusz@gmail.com>
Date: Thu, 19 Mar 2020 14:45:59 +0100
Subject: [PATCH] "Scenarios" chapter renamed to "Use cases"

---
 docs/CMakeLists.txt                              | 14 +++++++++-----
 docs/index.rst                                   |  2 +-
 docs/scenarios.rst                               | 16 ----------------
 docs/scenarios/custom_representation_types.rst   |  7 -------
 docs/use_cases.rst                               | 16 ++++++++++++++++
 docs/use_cases/custom_representation_types.rst   |  7 +++++++
 docs/{scenarios => use_cases}/extensions.rst     |  0
 .../legacy_interfaces.rst                        |  0
 .../unknown_units_and_dimensions.rst             |  0
 9 files changed, 33 insertions(+), 29 deletions(-)
 delete mode 100644 docs/scenarios.rst
 delete mode 100644 docs/scenarios/custom_representation_types.rst
 create mode 100644 docs/use_cases.rst
 create mode 100644 docs/use_cases/custom_representation_types.rst
 rename docs/{scenarios => use_cases}/extensions.rst (100%)
 rename docs/{scenarios => use_cases}/legacy_interfaces.rst (100%)
 rename docs/{scenarios => use_cases}/unknown_units_and_dimensions.rst (100%)

diff --git a/docs/CMakeLists.txt b/docs/CMakeLists.txt
index e8c52439..5140083c 100644
--- a/docs/CMakeLists.txt
+++ b/docs/CMakeLists.txt
@@ -63,6 +63,10 @@ add_custom_command(OUTPUT "${SPHINX_INDEX_FILE}"
                    WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
                    DEPENDS
                        "${CMAKE_CURRENT_SOURCE_DIR}/_static/css/custom.css"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/_static/img/concepts.png"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/_static/img/downcast_1.png"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/_static/img/downcast_2.png"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/_static/img/units.png"
                        "${CMAKE_CURRENT_SOURCE_DIR}/CHANGELOG.md"
                        "${CMAKE_CURRENT_SOURCE_DIR}/design.rst"
                        "${CMAKE_CURRENT_SOURCE_DIR}/design/directories.rst"
@@ -88,11 +92,11 @@ add_custom_command(OUTPUT "${SPHINX_INDEX_FILE}"
                        "${CMAKE_CURRENT_SOURCE_DIR}/reference/functions.rst"
                        "${CMAKE_CURRENT_SOURCE_DIR}/reference/systems.rst"
                        "${CMAKE_CURRENT_SOURCE_DIR}/reference/types.rst"
-                       "${CMAKE_CURRENT_SOURCE_DIR}/scenarios.rst"
-                       "${CMAKE_CURRENT_SOURCE_DIR}/scenarios/custom_representation_types.rst"
-                       "${CMAKE_CURRENT_SOURCE_DIR}/scenarios/extensions.rst"
-                       "${CMAKE_CURRENT_SOURCE_DIR}/scenarios/legacy_interfaces.rst"
-                       "${CMAKE_CURRENT_SOURCE_DIR}/scenarios/unknown_units_and_dimensions.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/use_cases.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/use_cases/custom_representation_types.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/use_cases/extensions.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/use_cases/legacy_interfaces.rst"
+                       "${CMAKE_CURRENT_SOURCE_DIR}/use_cases/unknown_units_and_dimensions.rst"
                        "${CMAKE_CURRENT_SOURCE_DIR}/usage.rst"
                        "${DOXYGEN_INDEX_FILE}"
                    MAIN_DEPENDENCY "${SPHINX_SOURCE}/conf.py"
diff --git a/docs/index.rst b/docs/index.rst
index 06e69441..0922e632 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -26,7 +26,7 @@ with a permissive `MIT license <https://github.com/mpusz/units/blob/master/LICEN
     quick_start
     usage
     framework
-    scenarios
+    use_cases
     design
     examples
     faq
diff --git a/docs/scenarios.rst b/docs/scenarios.rst
deleted file mode 100644
index f87cc18a..00000000
--- a/docs/scenarios.rst
+++ /dev/null
@@ -1,16 +0,0 @@
-Scenarios
-=========
-
-.. note::
-
-    For brevity all the code examples in this chapter assume::
-
-        using namespace units;
-
-.. toctree::
-    :maxdepth: 2
-
-    scenarios/unknown_units_and_dimensions
-    scenarios/legacy_interfaces
-    scenarios/custom_representation_types
-    scenarios/extensions
diff --git a/docs/scenarios/custom_representation_types.rst b/docs/scenarios/custom_representation_types.rst
deleted file mode 100644
index 3ee27ff6..00000000
--- a/docs/scenarios/custom_representation_types.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-.. namespace:: units
-
-Custom Representation Type
-==========================
-
-Customization points
---------------------
diff --git a/docs/use_cases.rst b/docs/use_cases.rst
new file mode 100644
index 00000000..603193b5
--- /dev/null
+++ b/docs/use_cases.rst
@@ -0,0 +1,16 @@
+Use Cases
+=========
+
+.. note::
+
+    For brevity all the code examples in this chapter assume::
+
+        using namespace units;
+
+.. toctree::
+    :maxdepth: 2
+
+    use_cases/unknown_units_and_dimensions
+    use_cases/legacy_interfaces
+    use_cases/custom_representation_types
+    use_cases/extensions
diff --git a/docs/use_cases/custom_representation_types.rst b/docs/use_cases/custom_representation_types.rst
new file mode 100644
index 00000000..f37fc63f
--- /dev/null
+++ b/docs/use_cases/custom_representation_types.rst
@@ -0,0 +1,7 @@
+.. namespace:: units
+
+Using Custom Representation Types
+=================================
+
+Customization points
+--------------------
diff --git a/docs/scenarios/extensions.rst b/docs/use_cases/extensions.rst
similarity index 100%
rename from docs/scenarios/extensions.rst
rename to docs/use_cases/extensions.rst
diff --git a/docs/scenarios/legacy_interfaces.rst b/docs/use_cases/legacy_interfaces.rst
similarity index 100%
rename from docs/scenarios/legacy_interfaces.rst
rename to docs/use_cases/legacy_interfaces.rst
diff --git a/docs/scenarios/unknown_units_and_dimensions.rst b/docs/use_cases/unknown_units_and_dimensions.rst
similarity index 100%
rename from docs/scenarios/unknown_units_and_dimensions.rst
rename to docs/use_cases/unknown_units_and_dimensions.rst