add in the plantuml plugin

.github/workflows/site.yml

@@ -21,6 +21,6 @@ jobs:
           path: .cache
           restore-keys: |
             mkdocs-material-
-      - run: pip install mkdocs-material
+      - run: pip install mkdocs-material plantuml-markdown
       - name: Deploy site
         run: mkdocs gh-deploy --force

docs/Developer/ProposalDM.md

@@ -0,0 +1,3 @@
+# ProposalDM
+
+The underlying proposal data model is defined in a [separate project](https://ivoa.github.io/ProposalDM/).

docs/Developer/api.md

@@ -1,8 +1,4 @@
-+++
-title = "Polaris REST API"
-type = "swagger"
-weight = 1
-description = "Reference for the Polaris API"
-+++
+# API
+
+A swagger Ui for the deployed api is available at https://kilburn.jb.man.ac.uk/pst/api/q/swagger-ui/
 
-{{< swaggerui src="../../../openapi/openapi.yaml" >}}

mkdocs.yml

@@ -21,6 +21,7 @@ nav:
       - Reference:
           - Use Cases: Developer/use-cases.md
           - Architecture: Developer/architecture.md
+          - Data Model: Developer/ProposalDM.md
           - API: Developer/api.md
       - Deployment:
           - Getting Started: Deployment/index.md
@@ -39,9 +40,8 @@ theme:
 markdown_extensions:
   - tables
   - footnotes
-# TODO add this once https://github.com/mikitex70/plantuml-markdown/pull/94 has been done
-#  - plantuml_markdown:
-#      server: https://www.plantuml.com/plantuml  # PlantUML server, for remote rendering
+  - plantuml_markdown:
+      server: https://www.plantuml.com/plantuml  # PlantUML server, for remote rendering
   - pymdownx.superfences:
       custom_fences:
         - name: mermaid