diff --git a/README.md b/README.md
index 9e5e966f..d6b8e8c0 100644
--- a/README.md
+++ b/README.md
@@ -238,9 +238,9 @@ the service connections. Approve the permissions and the pipeline is ready.
 | `target` | `standalone` \| `1es` \| `job` \| `stage` | `standalone` | Pipeline output format. `job` and `stage` generate reusable ADO YAML templates rather than complete pipelines. |
 | `engine` | string or object | `copilot` | Engine identifier or object with `id`, `model`, `timeout-minutes`, etc. |
 | `on` | object | — | Unified trigger configuration (`schedule`, `pipeline` completion, `pr` triggers). See [schedule syntax](#schedule-syntax). |
-| `pool` | string or object | `vmImage: ubuntu-22.04` (standalone) / `AZS-1ES-L-MMS-ubuntu-22.04` (1ES) | Agent pool |
+| `pool` | string or object | `vmImage: ubuntu-22.04` (standalone) / `AZS-1ES-L-MMS-ubuntu-22.04` (1ES) | Agent pool |
 | `workspace` | `root` \| `repo` \| `self` \| *alias* | auto | Working directory mode. `self` is an alias for `repo`; any checked-out repo alias is also accepted. |
-| `repos` | list | — | Compact repository declarations (replaces legacy `repositories:` + `checkout:`) |
+| `repos` | list | — | Compact repository declarations (replaces legacy `repositories:` + `checkout:`) |
 | `mcp-servers` | map | — | MCP server configuration |
 | `tools` | object | — | Tool configuration (`bash`, `edit`, `cache-memory`, `azure-devops`) |
 | `runtimes` | object | — | Runtime environment configuration (`lean`, `python`, `node`, `dotnet`) |
@@ -251,9 +251,9 @@ the service connections. Approve the permissions and the pipeline is ready.
 | `post-steps` | list | — | Inline steps after agent runs |
 | `setup` | list | — | Separate job before agentic task |
 | `teardown` | list | — | Separate job after safe outputs |
-| `network` | object | — | Additional allowed/blocked hosts |
-| `inlined-imports` | boolean | `false` | When `true`, resolves all `{{#runtime-import ...}}` markers at compile time; the generated YAML is self-contained but prompt-body edits require recompilation. See [runtime imports](docs/runtime-imports.md). |
-| `env` | map | — | Workflow-level environment variables (reserved, not yet implemented) |
+| `network` | object | — | Additional allowed/blocked hosts |
+| `inlined-imports` | boolean | `false` | When `true`, resolves all `{{#runtime-import …}}` markers at compile time; the generated YAML is self-contained but prompt-body edits require recompilation. See [runtime-imports.md](docs/runtime-imports.md). |
+| `env` | map | — | Workflow-level environment variables (reserved, not yet implemented) |
 
 ### Markdown Body
 
@@ -557,4 +557,4 @@ for automated releases via `release-please`.
 
 ## License
 
-See [LICENSE](LICENSE) for details.
+See [LICENSE](LICENSE) for details.
diff --git a/docs/front-matter.md b/docs/front-matter.md
index 99a954f9..8b63d634 100644
--- a/docs/front-matter.md
+++ b/docs/front-matter.md
@@ -59,6 +59,10 @@ runtimes:                      # optional runtime configuration (language enviro
   #   feed-url: "https://pkgs.dev.azure.com/myorg/_packaging/myfeed/nuget/v3/index.json"
 # env:                          # RESERVED: workflow-level environment variables (not yet implemented)
 #   CUSTOM_VAR: "value"
+# inlined-imports: false        # When true, resolve {{#runtime-import ...}} markers at compile time
+#                               # (default: false — markers are resolved at pipeline runtime, so
+#                               # prompt-body edits do not require recompilation).
+#                               # See docs/runtime-imports.md for full details.
 mcp-servers:
   my-custom-tool:              # containerized MCP server (requires container field)
     container: "node:20-slim"