docs: polish readability of quick-start and reference pages

- Friendlier, less jargon-heavy quick-start comments in README.
- Simplify the --config row in the README main-flags table.
- Replace <...> HTML entities with backtick code spans in
  generation.md and templates.md.
- Rephrase the supported-images note in configuration.md to drop the
  find-specific 'maxdepth 1' phrasing in favour of plain English.

4 files changed, 13 insertions, 12 deletions

diff --git a/README.md b/README.md
index a24b331..9ab7d1a 100644
--- a/README.md
+++ b/README.md
@@ -10,17 +10,17 @@ JavaScript.
 
 ```sh
 just build            # build ./bin/shuriken from src/
-sudo just install     # install to /usr/bin, /usr/share/shuriken, /etc/default
+sudo just install     # install command, templates, and default config
 shuriken --init       # creates ./shuriken.conf in the current directory
 ```
 
 Edit `shuriken.conf` and point `INCOMING_DIR` at a directory of photos, then:
 
 ```sh
-shuriken --dry-run    # preview the planned generation without writing anything
-shuriken --generate   # build the album into DIST_DIR (./dist by default)
-shuriken --sync       # rsync DIST_DIR/ to each configured SYNC_DESTINATIONS
-shuriken --clean      # remove DIST_DIR and leftover staging dirs
+shuriken --dry-run    # preview the planned generation (writes nothing)
+shuriken --generate   # build the album into ./dist (DIST_DIR)
+shuriken --sync       # publish ./dist to the configured remote hosts
+shuriken --clean      # remove ./dist and leftover staging dirs
 ```
 
 ImageMagick (`magick` or `convert`) and Bash 5.1 or newer are required.
@@ -38,7 +38,7 @@ ImageMagick (`magick` or `convert`) and Bash 5.1 or newer are required.
 | `--sync` | Publish `DIST_DIR/` to configured rsync destinations. |
 | `--clean` | Remove `DIST_DIR` and leftover `.shuriken.*.staging`/`.backup` dirs. |
 | `--version` | Print the program version. |
-| `--config PATH` | Select the config file for any config-backed action (default: `./shuriken.conf`). |
+| `--config PATH` | Select the config file to use (default: `./shuriken.conf`). |
 
 Common per-run overrides (see the full reference table in [docs/usage.md](docs/usage.md)):
 
diff --git a/docs/configuration.md b/docs/configuration.md
index 07bc1e0..d6471b4 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -38,10 +38,11 @@ values for the current run.
 
 ## Supported source images
 
-Only regular files in `INCOMING_DIR` (top level, `maxdepth 1`) with supported
-image extensions are processed as album images. Supported extensions are `jpg`,
-`jpeg`, `png`, `webp`, and `gif`, matched case-insensitively. Other files, such
-as `.txt` or `.md` notes, are ignored with a warning so generation can continue.
+Only regular files found directly in `INCOMING_DIR` (not in subdirectories) with
+supported image extensions are processed as album images. Supported extensions
+are `jpg`, `jpeg`, `png`, `webp`, and `gif`, matched case-insensitively. Other
+files, such as `.txt` or `.md` notes, are ignored with a warning so generation
+can continue.
 
 ## Validation
 
diff --git a/docs/generation.md b/docs/generation.md
index b477b30..c377adf 100644
--- a/docs/generation.md
+++ b/docs/generation.md
@@ -110,6 +110,6 @@ file instead (it is copied in as `favicon.ico`).
 ## Source URL
 
 The page header bar links to the project source ("Site generated … with
-<URL>"). This defaults to the shuriken.sh repository; set `SOURCE_URL` in
+`<URL>`"). This defaults to the shuriken.sh repository; set `SOURCE_URL` in
 the config or pass `--source-url URL` to point it at your own album's repository
 instead. The displayed link text is the URL with its scheme removed.
\ No newline at end of file
diff --git a/docs/templates.md b/docs/templates.md
index f34be9d..8d26f61 100644
--- a/docs/templates.md
+++ b/docs/templates.md
@@ -28,7 +28,7 @@ used when `STATS_PAGE=yes`.
 ## Header bar and footer
 
 * The page **header bar** (`header.tmpl`) renders the "Site generated … with
-  &lt;SOURCE_URL&gt;" link and, when `STATS_PAGE=yes`, the `Stats` navigation
+  `<SOURCE_URL>`" link and, when `STATS_PAGE=yes`, the `Stats` navigation
   link.
 * The page **footer** (`footer.tmpl`) renders the "Download all photos in
   original size" tarball link, shown only when `TARBALL_INCLUDE=yes`.
\ No newline at end of file