Public landing: stop publishing design system; serve lightweight /documentation/index

rismay · rismay · commit 8fa334c0316c · 2026-02-13T05:11:03.000-08:00
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
@@ -25,30 +25,24 @@ jobs:
       - name: Checkout source
         uses: actions/checkout@v4
 
-      - name: Set up Swift
-        uses: swift-actions/setup-swift@v2
-        with:
-          swift-version: '6.2'
-
-      - name: Build DocC
+      - name: Build site (public landing only)
         run: |
           set -euo pipefail
           output_root="${GITHUB_WORKSPACE}/_site"
           rm -rf "${output_root}"
           mkdir -p "${output_root}"
-          docc convert "design-system.docc" \
-            --output-path "${output_root}" \
-            --transform-for-static-hosting \
-            --hosting-base-path /
 
-          # Documentation index fallback (only when DocC didn't generate it).
-          if [ -f "documentation/index/index.html" ] && [ ! -f "${output_root}/documentation/index/index.html" ]; then
-            mkdir -p "${output_root}/documentation/index"
-            cp "documentation/index/index.html" "${output_root}/documentation/index/index.html"
-          fi
+          # Public site policy:
+          # - This site is a *public hint* about Wrkstrm.
+          # - Do NOT publish internal design-system/provisioned/private docs here.
+
+          # Serve the public landing at /documentation/index/
+          mkdir -p "${output_root}/documentation/index"
+          cp "documentation/index/index.html" "${output_root}/documentation/index/index.html"
 
           # Root landing should go to the documentation index.
           echo '<!DOCTYPE html><html><head><meta http-equiv="refresh" content="0; url=/documentation/index/"></head></html>' > "${output_root}/index.html"
+
           touch "${output_root}/.nojekyll"
 
       - name: Upload Pages artifact
diff --git a/documentation/index/index.html b/documentation/index/index.html
@@ -3,23 +3,23 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>Technology</title>
-    <meta name="description" content="Main technology root for Wrkstrm." />
+    <title>Wrkstrm</title>
+    <meta name="description" content="Wrkstrm: systems-first engineering and product work." />
     <style>
       :root { color-scheme: light; }
       body {
-        font-family: "Palatino Linotype", Palatino, "Times New Roman", serif;
+        font-family: ui-serif, "Palatino Linotype", Palatino, "Times New Roman", serif;
         margin: 0;
         background: #f8f6f1;
         color: #141310;
       }
       main {
-        max-width: 780px;
+        max-width: 820px;
         margin: 12vh auto;
         padding: 0 24px 64px;
       }
       h1 {
-        font-size: 2.5rem;
+        font-size: 2.6rem;
         letter-spacing: -0.02em;
         margin: 0 0 12px;
       }
@@ -28,6 +28,9 @@
         line-height: 1.6;
         margin: 0 0 16px;
       }
+      .hint {
+        opacity: 0.82;
+      }
       a {
         color: #1f4acc;
         text-decoration: none;
@@ -36,13 +39,36 @@
       a:hover {
         border-bottom-color: #1f4acc;
       }
+      .card {
+        margin-top: 28px;
+        padding: 18px 18px;
+        border: 1px solid rgba(20, 19, 16, 0.12);
+        border-radius: 12px;
+        background: rgba(255, 255, 255, 0.55);
+      }
+      code {
+        font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
+        font-size: 0.95em;
+      }
     </style>
   </head>
   <body>
     <main>
-      <h1>Technology</h1>
-      <p>This is the main technology root for Wrkstrm.</p>
-      <p>Full documentation lives at <a href="/documentation/wrkstrm/">/documentation/wrkstrm/</a>.</p>
+      <h1>Wrkstrm</h1>
+      <p class="hint">
+        This is a public landing page. Detailed technical documentation (including design systems) is maintained in
+        provisioned/private spaces.
+      </p>
+
+      <div class="card">
+        <p>
+          If you expected internal docs under <code>/documentation/…</code>, you’re in the right neighborhood — this
+          endpoint is intentionally lightweight.
+        </p>
+        <p>
+          Contact: <a href="mailto:hello@wrkstrm.com">hello@wrkstrm.com</a>
+        </p>
+      </div>
     </main>
   </body>
 </html>
diff --git a/documentation/index/index.md b/documentation/index/index.md
@@ -1,5 +1,5 @@
-# Technology
+# Wrkstrm
 
-This is the main technology root for Wrkstrm.
+This is the public landing page for Wrkstrm.
 
-Full documentation lives at /documentation/wrkstrm/.
+Detailed technical documentation (including design systems) is maintained in provisioned/private spaces.
