Made multiple little corrections. Removed the html file extensions in the examples.

Author: jnbdz

.gitignore

@@ -3,3 +3,4 @@ site/
 __pycache__/
 *.pyc
 .DS_Store
+.idea/

Makefile

@@ -4,10 +4,10 @@ start: ## Start mkdocs server
 	@if [[ -f ".venv/bin/activate" && -x ".venv/bin/python" ]]; then \
 		echo "Using virtualenv Python"; \
 		. .venv/bin/activate; \
-		python -m mkdocs serve; \
+		python -m mkdocs serve -a localhost:8884; \
 	else \
 		echo "Virtualenv not found. Using system Python"; \
-		python -m mkdocs serve; \
+		python -m mkdocs serve -a localhost:8884; \
 	fi
 
 build: ## Build mkdocs site

docs/examples.md

@@ -10,7 +10,7 @@ The simplest possible view descriptor: a single template with no slots.
 
 ```json title="vdp-simple.json"
 {
-  "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/forms/form.html"
+  "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/forms/form"
 }
 ```
 
@@ -19,7 +19,7 @@ The server might deliver this via the `View-Template` HTTP header:
 ```http
 HTTP/1.1 200 OK
 Content-Type: application/json
-View-Template: https://github.com/SiteNetSoft/quarkus-pha/templates/components/forms/form.html
+View-Template: https://github.com/SiteNetSoft/quarkus-pha/templates/components/forms/form
 
 {"csrfToken": "abc123", "loginUrl": "/auth/login"}
 ```
@@ -34,22 +34,22 @@ A layout template with nested slots, forming a template tree. The sidebar layout
 
 ```json title="vdp-composed.json"
 {
-  "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/layouts/sidebar.html",
+  "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/layouts/sidebar",
   "slots": {
     "sidebarNav": {
-      "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/navigation/nav.html"
+      "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/navigation/nav"
     },
     "mainContent": {
-      "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/demos/dashboard.html",
+      "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/demos/dashboard",
       "slots": {
         "statsCards": {
-          "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/card.html"
+          "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/card"
         },
         "activityTable": {
-          "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/table.html"
+          "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/table"
         },
         "revenueChart": {
-          "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/charts/chart.html"
+          "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/charts/chart"
         }
       }
     }
@@ -60,12 +60,12 @@ A layout template with nested slots, forming a template tree. The sidebar layout
 The resulting template tree:
 
 ```
-sidebar.html
-├── sidebarNav → nav.html
-└── mainContent → dashboard.html
-    ├── statsCards → card.html
-    ├── activityTable → table.html
-    └── revenueChart → chart.html
+sidebar
+├── sidebarNav → nav
+└── mainContent → dashboard
+    ├── statsCards → card
+    ├── activityTable → table
+    └── revenueChart → chart
 ```
 
 This descriptor would typically be served as a standalone resource referenced via `Link` header:
@@ -86,18 +86,18 @@ Multiple named views for the same API response. The client selects a view based
 {
   "views": {
     "default": {
-      "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/demos/dashboard.html",
+      "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/demos/dashboard",
       "slots": {
         "statsCards": {
-          "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/card.html"
+          "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/card"
         },
         "activityTable": {
-          "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/table.html"
+          "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/table"
         }
       }
     },
     "compact": {
-      "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/card.html"
+      "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/card"
     }
   }
 }
@@ -126,30 +126,30 @@ A single slot accepting multiple templates rendered in sequence. Each element is
 
 ```json title="vdp-slot-array.json"
 {
-  "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/layouts/sidebar.html",
+  "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/layouts/sidebar",
   "slots": {
     "mainContent": [
       {
-        "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/card.html"
+        "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/card"
       },
       {
-        "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/charts/chart.html"
+        "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/charts/chart"
       },
       {
-        "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/table.html"
+        "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/data-display/table"
       }
     ],
     "sidebarNav": {
-      "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/navigation/nav.html"
+      "template": "https://github.com/SiteNetSoft/quarkus-pha/templates/components/navigation/nav"
     }
   }
 }
 ```
 
 The `mainContent` slot receives an array of three view descriptors. The client MUST render them in order:
 
-1. `card.html`
-2. `chart.html`
-3. `table.html`
+1. `card`
+2. `chart`
+3. `table`
 
 Each array element can itself contain nested `slots` for further composition.

docs/index.md

@@ -33,23 +33,23 @@ VDP works with **any rendering framework** — HTML/Qute, SwiftUI, Jetpack Compo
 
 ### Template Binding
 
-The server declares *which* templates render *which* data. Templates handle data binding using their own mechanisms (Qute expressions, JSONPath, etc.).
+The server declares *which* templates render *which* data. Templates handle data binding using their own mechanisms (Qute expressions, mustache, Apache FreeMarker, JSONPath, etc.).
 
 </div>
 
 <div class="vdp-feature" markdown>
 
 ### Recursive Slots
 
-Templates compose via named slots. Each slot value is itself a view descriptor, enabling arbitrarily deep template trees.
+Templates compose via named slots. Each slot value is itself a view descriptor, enabling arbitrarily deep template trees — in other words, templates within templates.
 
 </div>
 
 <div class="vdp-feature" markdown>
 
 ### Dual Transport
 
-Embed view descriptors inline (`_view` / `_views` in HAL+JSON) or reference them via HTTP `Link` headers (RFC 8288) for constrained formats like OData4.
+Embed view descriptors inline (`_view` / `_views` in HAL+JSON) or reference them via HTTP `Link` headers ([RFC 8288](https://www.rfc-editor.org/rfc/rfc8288)) for constrained formats like OData4.
 
 </div>
 
@@ -73,7 +73,7 @@ One API response, multiple views. Serve different template trees for desktop, mo
 
 ### Standards-Compatible
 
-Built on REST, HAL, RFC 8288, and OData4. VDP extends existing standards without breaking them.
+Built on REST, HAL, [RFC 8288](https://www.rfc-editor.org/rfc/rfc8288), and OData4. VDP extends existing standards without breaking them.
 
 </div>
 
@@ -85,21 +85,21 @@ A VDP view descriptor tells the client to render a sidebar layout, filling its s
 
 ```json
 {
-  "template": "https://example.com/templates/layouts/sidebar.html",
+  "template": "https://example.com/templates/layouts/sidebar",
   "slots": {
     "mainContent": {
-      "template": "https://example.com/templates/dashboard.html",
+      "template": "https://example.com/templates/dashboard",
       "slots": {
         "statsCards": {
-          "template": "https://example.com/templates/components/card.html"
+          "template": "https://example.com/templates/components/card"
         },
         "activityTable": {
-          "template": "https://example.com/templates/components/table.html"
+          "template": "https://example.com/templates/components/table"
         }
       }
     },
     "sidebarNav": {
-      "template": "https://example.com/templates/components/nav.html"
+      "template": "https://example.com/templates/components/nav"
     }
   }
 }
@@ -113,3 +113,6 @@ VDP is in **early working draft** stage (v0.1, alpha). The specification is bein
 [GitHub Organization](https://github.com/ViewDescriptorProtocol){ .secondary }
 [JSON Schema](schema.md){ .secondary }
 </div>
+
+*[VDP]: View Descriptor Protocol
+*[HAL]: Hypertext Application Language