docs: update cli and config docs for new flags and config fields

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: rsbh

docs/cli.mdx

@@ -10,7 +10,7 @@ Chronicle provides a CLI to initialize, develop, build, and serve your documenta
 
 ## init
 
-Initialize a new Chronicle project. Must be run before other commands.
+Initialize a new Chronicle project.
 
 ```bash
 chronicle init [options]
@@ -37,7 +37,8 @@ chronicle dev [options]
 
 | Flag | Description | Default |
 |------|-------------|---------|
-| `-c, --content <path>` | Content directory | `content` |
+| `--content <path>` | Content directory | `content` |
+| `--config <path>` | Path to `chronicle.yaml` | `./chronicle.yaml` |
 | `-p, --port <port>` | Port number | `3000` |
 
 ## build
@@ -50,7 +51,8 @@ chronicle build [options]
 
 | Flag | Description | Default |
 |------|-------------|---------|
-| `-c, --content <path>` | Content directory | `content` |
+| `--content <path>` | Content directory | `content` |
+| `--config <path>` | Path to `chronicle.yaml` | `./chronicle.yaml` |
 | `--preset <preset>` | Deploy preset (`vercel`, `cloudflare`, `node-server`) | — |
 
 ## start
@@ -63,7 +65,7 @@ chronicle start [options]
 
 | Flag | Description | Default |
 |------|-------------|---------|
-| `-c, --content <path>` | Content directory | `content` |
+| `--content <path>` | Content directory | `content` |
 | `-p, --port <port>` | Port number | `3000` |
 
 ## serve
@@ -76,13 +78,17 @@ chronicle serve [options]
 
 | Flag | Description | Default |
 |------|-------------|---------|
-| `-c, --content <path>` | Content directory | `content` |
+| `--content <path>` | Content directory | `content` |
+| `--config <path>` | Path to `chronicle.yaml` | `./chronicle.yaml` |
 | `-p, --port <port>` | Port number | `3000` |
 | `--preset <preset>` | Deploy preset (`vercel`, `cloudflare`, `node-server`) | — |
 
-## Config Resolution
+## Resolution Order
 
-`chronicle.yaml` is resolved in this order:
+CLI flags take precedence over `chronicle.yaml` values, which take precedence over defaults.
 
-1. Current working directory
-2. Content directory
+| Option | CLI flag | Config field | Default |
+|--------|----------|-------------|---------|
+| Content directory | `--content` | `content` | `content` |
+| Deploy preset | `--preset` | `preset` | — |
+| Config path | `--config` | — | `./chronicle.yaml` |

docs/components.mdx

@@ -203,7 +203,7 @@ Chronicle overrides these HTML elements with styled components:
 | HTML Element | Chronicle Component | Notes |
 |-------------|-------------------|-------|
 | `<p>` | `MdxParagraph` | Auto-converts to `<div>` when containing block elements |
-| `<img>` | `Image` | Next.js optimized for local, standard for external |
+| `<img>` | `Image` | Optimized for local, standard for external |
 | `<a>` | `Link` | Smart routing with external link detection |
 | `<code>` | `MdxCode` | Inline code styling |
 | `<pre>` | `MdxPre` | Code blocks with optional title header |

docs/configuration.mdx

@@ -6,14 +6,16 @@ order: 3
 
 # Configuration
 
-All site configuration lives in a single `chronicle.yaml` file in your content directory.
+All site configuration lives in a single `chronicle.yaml` file in your project root. The config is validated using Zod — invalid fields will produce clear error messages at startup.
 
 ## Full Example
 
 ```yaml
 title: My Project Docs
 description: Documentation for My Project
 url: https://docs.example.com
+content: docs
+preset: vercel
 
 logo:
   light: ./logo-light.png
@@ -80,6 +82,22 @@ Optional site URL. Used for SEO metadata, sitemap, and canonical URLs.
 url: https://docs.example.com
 ```
 
+### content
+
+Optional content directory path. Can be overridden by the `--content` CLI flag.
+
+```yaml
+content: docs
+```
+
+### preset
+
+Optional deploy preset. Can be overridden by the `--preset` CLI flag.
+
+```yaml
+preset: vercel # vercel, cloudflare, or node-server
+```
+
 ### description
 
 Optional meta description for SEO.