docs: "Introduction" changed to "Tag Index" for examples

docs/users_guide/examples/introduction.md

@@ -1,6 +0,0 @@
-# Introduction
-
-All usage examples in this chapter are categorized with appropriate tags to simplify navigation and search
-of relevant code.
-
-[TAGS]

docs/users_guide/examples/tags_index.md

@@ -0,0 +1,10 @@
+# Tags Index
+
+!!! note
+
+    All usage examples in this chapter are categorized with appropriate tags to simplify navigation and
+    search of relevant code. You can either read all the examples one-by-one in the order provided by
+    the documentation authors or, thanks to the tagging system, jump straight to the example that is
+    the most interesting for you.
+
+[TAGS]

mkdocs.yml

@@ -53,7 +53,7 @@ theme:
 plugins:
   - search
   - tags:
-      tags_file: users_guide/examples/introduction.md
+      tags_file: users_guide/examples/tags_index.md
 
 # Customization
 extra:
@@ -138,7 +138,7 @@ nav:
           - Interoperability with Other Units Libraries: users_guide/use_cases/interoperability_with_other_units_libraries.md
           - Extending the Library: users_guide/use_cases/extending_the_library.md
       - Examples:
-          - Introduction: users_guide/examples/introduction.md
+          - Tags Index: users_guide/examples/tags_index.md
           - hello_units: users_guide/examples/hello_units.md
   - Library Reference:
       - Core Library: library_reference/core_library.md