docs: consolidate CLI docs into command reference

Author: tobiasraabe

docs/source/_static/css/custom.css

@@ -127,3 +127,34 @@ body[data-md-color-scheme="slate"] .home-tile p {
         box-shadow: 0 12px 26px rgba(2, 6, 23, 0.46);
     }
 }
+
+.md-typeset dl.cli-reference {
+    margin: 0.75rem 0 1.25rem;
+}
+
+.md-typeset dl.cli-reference dt {
+    margin: 0.85rem 0 0;
+    font-weight: 500;
+}
+
+.md-typeset dl.cli-reference dd {
+    margin: 0.2rem 0 0.75rem 1.5rem;
+}
+
+.md-typeset dl.cli-reference dd p {
+    margin: 0;
+}
+
+.md-typeset dl.cli-reference dd p + p {
+    margin-top: 0.25rem;
+    color: var(--md-default-fg-color--light);
+}
+
+.md-typeset dl.cli-reference dt a,
+.md-typeset dl.cli-reference dt a:hover,
+.md-typeset dl.cli-reference dt a:focus,
+.md-typeset dl.cli-reference dt a:visited {
+    color: inherit;
+    text-decoration: none;
+    border-bottom: 0;
+}

docs/source/api/cli_and_programmatic.md

@@ -2,7 +2,8 @@
 
 This page documents the public CLI-related imports from `pytask`.
 
-For command usage and options, see the [CLI reference](../commands/index.md).
+For command usage and options, see the
+[command reference](../reference_guides/commands.md).
 
 ## Command Line Entry Point
 

docs/source/commands/build.md

@@ -99,8 +99,8 @@ When you are using the `.name` attributes of the dimensions and multi-dimensiona
 objects like in the example above, you ensure that the names of dimensions are included
 in all downstream tasks.
 
-Thus, you can simply call [`pytask -k`](../commands/build.md#options) with the following
-expression to execute all tasks related to the logit model.
+Thus, you can simply call [`pytask -k`](../reference_guides/commands.md#pytask-build--k)
+with the following expression to execute all tasks related to the logit model.
 
 ```console
 pytask -k logit