fix: rearrange

Author: tobiasraabe

docs/source/index.md

@@ -70,5 +70,3 @@ If you want to know more about pytask, dive into one of the following topics.
     <p>API and implementation details for developers and plugin authors.</p>
   </a>
 </div>
-
-For command-line usage, see the [command reference](reference_guides/commands.md).

docs/source/reference_guides/api/utilities_and_typing.md

@@ -2,15 +2,22 @@
 
 ## Path Utilities
 
-::: pytask.path.import_path options: show_root_heading: true show_signature: true :::
-pytask.get_state_of_path ::: pytask.path.hash_path
+::: pytask.path.import_path
+    options:
+      show_root_heading: true
+      show_signature: true
+::: pytask.get_state_of_path
+::: pytask.path.hash_path
 
 ## Tree Utilities
 
-::: pytask.tree_util.tree_flatten_with_path ::: pytask.tree_util.tree_leaves :::
-pytask.tree_util.tree_map ::: pytask.tree_util.tree_map_with_path :::
-pytask.tree_util.tree_structure
+::: pytask.tree_util.tree_flatten_with_path
+::: pytask.tree_util.tree_leaves
+::: pytask.tree_util.tree_map
+::: pytask.tree_util.tree_map_with_path
+::: pytask.tree_util.tree_structure
 
 ## Typing Helpers
 
-::: pytask.Product ::: pytask.is_task_function
+::: pytask.Product
+::: pytask.is_task_function

mkdocs.yml

@@ -62,22 +62,22 @@ nav:
       - Pluggy: explanations/pluggy.md
   - Reference Guides:
       - Overview: reference_guides/index.md
+      - API:
+          - Overview: api/index.md
+          - CLI Imports: api/cli_and_programmatic.md
+          - Functional Interfaces: api/functional_interfaces.md
+          - Core Classes And Exceptions: api/core_classes_and_exceptions.md
+          - Marks: api/marks.md
+          - Nodes And Tasks: api/nodes_and_tasks.md
+          - Outcomes, Reports, And Warnings: api/outcomes_reports_and_warnings.md
+          - Utilities And Typing: api/utilities_and_typing.md
       - Commands: reference_guides/commands.md
       - Configuration: reference_guides/configuration.md
-      - Lockfile: reference_guides/lockfile.md
       - Hook Specifications: reference_guides/hookspecs.md
-      - Type Hints: type_hints.md
-      - Developer's Guide: developers_guide.md
-      - Glossary: glossary.md
-  - API:
-      - Overview: api/index.md
-      - CLI Imports: api/cli_and_programmatic.md
-      - Functional Interfaces: api/functional_interfaces.md
-      - Core Classes And Exceptions: api/core_classes_and_exceptions.md
-      - Marks: api/marks.md
-      - Nodes And Tasks: api/nodes_and_tasks.md
-      - Outcomes, Reports, And Warnings: api/outcomes_reports_and_warnings.md
-      - Utilities And Typing: api/utilities_and_typing.md
+      - Lockfile: reference_guides/lockfile.md
+      - Type Hints: reference_guides/type_hints.md
+      - Developer's Guide: reference_guides/developers_guide.md
+      - Glossary: reference_guides/glossary.md
   - Plugin List: plugin_list.md
   - Changelog: changes.md