Docs updates

docs/docs/documentation/administration/commons/_markdown-semantics.md

@@ -133,5 +133,6 @@ These are the semantics suggestions.
     - `zenodo.related_identifiers.isRequiredBy`
     - `zenodo.related_identifiers.isObsoletedBy`
     - `zenodo.related_identifiers.obsoletes`
+    - `zenodo.publication_date`
   </TabItem>
 </Tabs>

docs/docs/documentation/for-devs/apis/swagger.md

@@ -3,4 +3,29 @@ sidebar_position: 1
 description: A brief guide on the API documentation tool this platform uses
 ---
 
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+import Admonition from '@theme/Admonition';
+
 # Swagger
+
+The swagger UI is available at the `/swagger-ui/index.html` url. It contains documentation for the following API endpoints.
+
+<Tabs>
+  <TabItem value="public" label="Public API">
+
+    - **/api/public/dmps/\*\***
+    - **/api/public/descriptions/\*\***
+
+  </TabItem>
+  <TabItem value="internal" label="Internal API">
+
+    - **/api/dmp/\*\***
+    - **/api/description/\*\***
+
+    <Admonition type="info">
+      <p>These endpoints require authentication.</p>
+    </Admonition>
+
+  </TabItem>
+</Tabs>