From 9788e0d2b7b3a2914f018ae4d24b840702dee198 Mon Sep 17 00:00:00 2001
From: Julian Stirling <julian@julianstirling.co.uk>
Date: Sun, 1 Mar 2026 10:20:32 +0000
Subject: [PATCH] Adjust developer docs front page and add JSON links on HTTP
 page

---
 apidocs/http/index.html |  4 ++++
 apidocs/index.html      | 18 +++++++++++++-----
 2 files changed, 17 insertions(+), 5 deletions(-)
diff --git a/apidocs/http/index.html b/apidocs/http/index.html
index bb34ec7c..834167b3 100644
--- a/apidocs/http/index.html
+++ b/apidocs/http/index.html
@@ -64,6 +64,10 @@
       <code>http://microscope.local:5000/docs</code>
     </p>
 
+    <p>
+      You can also directly inspect the OpenAPI JSON file <a href="./openapi.json">openapi.json</a> or the WC3 "Web of Things" Thing Descriptions JSON <a href="./thing_descriptions.json">thing_descriptions.json</a>
+    </p>
+
     <aside>
       Replace <strong>microscope.local</strong> with your microscope's hostname or IP address
       if your network uses a different name.
diff --git a/apidocs/index.html b/apidocs/index.html
index a3725b18..402f8717 100644
--- a/apidocs/index.html
+++ b/apidocs/index.html
@@ -3,7 +3,7 @@
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>OpenFlexure Microscope Server API Docs</title>
+<title>OpenFlexure Microscope Server Developer Documentation</title>
 
 <link href="https://fonts.googleapis.com/css2?family=Open+Sans:wght@400;600&display=swap" rel="stylesheet">
 
@@ -21,9 +21,15 @@ body {
   padding: 0 1.5rem;
 }
 
+.main-content {
+  max-width: 700px;
+  padding: 2rem;
+}
+
 h1 {
   color: #c5247f;
   margin-bottom: 0.5rem;
+  text-align: center;
 }
 
 a {
@@ -49,11 +55,13 @@ a:hover {
 <body>
 
 <div class="content">
-  <h1>OpenFlexure Microscope Server API Docs</h1>
-  <p>Select documentation:</p>
+  <h1>OpenFlexure Microscope Server Developer Documentation</h1>
+    <div class="main-content">
+    <p>Select documentation:</p>
 
-  <a href="./http/index.html">HTTP API (Swagger)</a>
-  <a href="./python/index.html">Python API</a>
+    <a href="./http/index.html">HTTP API (Swagger)</a>
+    <a href="./python/index.html">Python API</a>
+  </div>
 </div>
 
 </body>
