Merge pull request #526 from chaen/doc_review_admin

Actually Write the admin doc

Author: chrisburr

docs/dev/explanations/components/cli.md

@@ -6,7 +6,7 @@ The `diracx-cli` is a command-line interface built on `diracx-client` and `dirac
 
 CLI commands are located in `diracx-cli/src/diracx/cli/`. To create a CLI command:
 
-1. Import `AsyncDiracClient` and/or the diracx API.
+1. Import `AsyncDiracClient` and/or `diracx-api`.
 2. Import `utils.AsyncTyper`.
 3. Use the `@app.async_command` decorator to define commands.
 

docs/dev/tutorials/run-locally.md

@@ -1,4 +1,4 @@
-## Run a full diracx demo
+## Run a full DiracX demo
 
 TODO: expand
 

mkdocs.yml

@@ -69,32 +69,26 @@ nav:
     - Consortium: project/consortium.md
 
 markdown_extensions:
+  - admonition
   - def_list
   - pymdownx.tasklist:
       custom_checkbox: true
   - attr_list
   - pymdownx.emoji:
       emoji_index: !!python/name:material.extensions.emoji.twemoji
       emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - pymdownx.details
   - pymdownx.superfences:
       custom_fences:
         - name: mermaid
           class: mermaid
           format: !!python/name:pymdownx.superfences.fence_code_format
-  - pymdownx.highlight:
-      anchor_linenums: true
-      line_spans: __span
-      pygments_lang_class: true
   - pymdownx.inlinehilite
   - pymdownx.snippets
-  - pymdownx.superfences
   - pymdownx.highlight:
       anchor_linenums: true
       line_spans: __span
       pygments_lang_class: true
-  - pymdownx.inlinehilite
-  - pymdownx.snippets
-  - pymdownx.superfences
   - tables
 
 plugins: