Refactor documentation to emphasize Majestic's identity-driven architecture. Updated descriptions in the index and overview files for clarity, and modified footer copyright statement. Enhanced CSS for improved layout density in the documentation site.

Author: stephenway

docs/.vitepress/config.mts

@@ -72,7 +72,7 @@ export default defineConfig({
     socialLinks: [],
     footer: {
       message: 'Contract version and hash embedded at build time.',
-      copyright: 'Majestic — local-first, identity-driven media server.',
+      copyright: 'Built from canonical contract bundle.',
     },
 
     outline: [2, 3],

docs/.vitepress/theme/majestic.css

@@ -55,3 +55,16 @@
 :root:not(.dark) {
   color-scheme: dark;
 }
+
+/* Spec site: tighter density, less marketing air */
+.VPHome .VPHero {
+  padding-top: 2rem;
+  padding-bottom: 1.5rem;
+}
+.VPHome .vp-doc {
+  padding-top: 1rem;
+}
+.VPHome .vp-doc h2 {
+  margin-top: 1.5rem;
+  margin-bottom: 0.75rem;
+}

docs/index.md

@@ -4,19 +4,13 @@ layout: home
 
 # Majestic Core — Technical Documentation
 
-Majestic is a local-first, identity-driven media server. Version, hash, and build time are in the footer.
-
----
+Majestic is a local-first media server built on immutable edition identity.
 
 ## Sections
 
 | Section | Description |
 |---------|-------------|
 | [Architecture](/architecture/) | Identity, API, build, streaming, data lineage |
-| [API Contracts](/contracts/) | Wire contract, schemas, versioning, bundle download |
+| [Contracts](/contracts/) | Schemas, versioning, canonical bundle |
 | [Integration](/integration/) | Client integration patterns |
 | [Invariants](/invariants/) | Breaking-change rules, compatibility policy |
-
----
-
-No hero graphics. No slogans. This is a specification.

docs/overview.md

@@ -1,6 +1,6 @@
 # Overview
 
-Majestic is a local-first, identity-driven media server.
+Majestic is a local-first media server built on immutable edition identity.
 
 ## Principles
 
@@ -14,6 +14,6 @@ Majestic is a local-first, identity-driven media server.
 | Section | Contents |
 |---------|----------|
 | [Architecture](/architecture/) | Identity, API, build, streaming, data lineage |
-| [Contracts](/contracts/) | Wire contract, schemas, versioning, bundle |
+| [Contracts](/contracts/) | Schemas, versioning, canonical bundle |
 | [Integration](/integration/) | Client integration patterns |
 | [Invariants](/invariants/) | Breaking-change rules, compatibility policy |