fix(docs): improve layout width and AsciiDoc table rendering

- Increase main content max-width to 1050px for better readability on large screens
- Reduce main content horizontal padding to 1.5rem to prevent layout squishing
- Fix table rendering by changing table-layout to auto, allowing AsciiDoc column widths to be respected naturally
- Remove aggressive `overflow-wrap: anywhere` from tables to stop words from breaking mid-line
- Retain native collapsible sidebar (TOC) functionality

Author: jknack

docs/asciidoc/modules/openapi.adoc

@@ -411,7 +411,7 @@ Whitespaces (including new lines) are ignored. To introduce a new line, you must
 |===
 | Tag | Main | Controller | Method | Description
 
-|@version 4.0.4
+|@version
 | [x]
 |
 |

docs/js/styles/theme.css

@@ -28,7 +28,7 @@
 
   /* Layout */
   --sidebar-width: 300px;
-  --content-max-width: 900px;
+  --content-max-width: 1050px; /* INCREASED from 900px */
   --border-radius: 6px;
 
   /* Typography Stacks */
@@ -129,7 +129,7 @@ li { margin-bottom: 0.35rem; }
   #content, #footer {
     max-width: var(--content-max-width);
     margin: 0 auto;
-    padding: 2.5rem 3rem;
+    padding: 2.5rem 1.5rem; /* REDUCED horizontal padding */
   }
 }
 
@@ -558,13 +558,13 @@ pre.highlightjs.badges-loaded code { opacity: 1; }
    ========================================================================== */
 table.tableblock {
   width: 100%;
-  table-layout: fixed !important;
+  table-layout: auto; /* FIXED: Let the browser respect Asciidoc col widths */
   border-collapse: separate;
   border-spacing: 0;
   margin: 1.5rem 0;
   border: 1px solid var(--border-color);
   border-radius: var(--border-radius);
-  overflow: hidden;
+  overflow-x: auto;
 }
 
 table.tableblock td, table.tableblock th {
@@ -575,20 +575,14 @@ table.tableblock td, table.tableblock th {
   text-align: left;
   vertical-align: top;
   word-wrap: break-word;
-  overflow-wrap: anywhere;
+  overflow-wrap: break-word; /* FIXED: Removed 'anywhere' word chopping */
 }
 
 table.tableblock thead th {
   background-color: var(--bg-surface);
   font-weight: 600;
   border-bottom: 2px solid var(--border-color);
   color: var(--heading-color);
-  white-space: nowrap;
-}
-
-table.tableblock:not(:has(colgroup col[style*="width"])) td:first-child {
-  white-space: nowrap;
-  width: 1%;
 }
 
 table.tableblock td:first-child { font-weight: 500; color: var(--heading-color); }
@@ -800,4 +794,3 @@ html[data-theme="dark"] .DocSearch-Button-Keys kbd {
   color: #e2e8f0 !important;
   background: #334155 !important;
 }
-

docs/src/main/java/io/jooby/adoc/DocApp.java

@@ -7,7 +7,9 @@
 
 import static org.slf4j.helpers.NOPLogger.NOP_LOGGER;
 
+import java.nio.file.Files;
 import java.nio.file.Path;
+import java.nio.file.StandardCopyOption;
 import java.util.Arrays;
 import java.util.List;
 
@@ -51,6 +53,7 @@ public static void main(String[] args) throws Exception {
     runApp(args, server, DocApp::new);
 
     Path outdir = basedir.resolve("asciidoc").resolve("site");
+    Path themeCssDir = basedir.resolve("js").resolve("styles");
 
     DirectoryWatcher watcher =
         DirectoryWatcher.builder()
@@ -69,6 +72,8 @@ public static void main(String[] args) throws Exception {
                         } catch (Exception x) {
                           log.error("Site build resulted in exception", x);
                         }
+                      } else if (file.toString().endsWith("theme.css")) {
+                        Files.copy(file, outdir.resolve("js").resolve("styles").resolve("theme.css"), StandardCopyOption.REPLACE_EXISTING);
                       }
                   }
                 })