Skip to content

docs: split reference and policy detail into docs/ - #93

Merged
gronke merged 1 commit into
mainfrom
docs/readme-cli-actions
Sep 4, 2026
Merged

gronke merged 1 commit into
mainfrom
docs/readme-cli-actions

Conversation

@gronke

@gronke gronke commented Sep 4, 2026

Copy link
Copy Markdown
Owner

The README is an overview again (240 to 144 lines).

  • docs/CLI.md: every build flag and its package.json key.
  • docs/POLICIES.md: HTML policy, duplicate output paths, the output directory and the symlink modes; they bind the library (Processors, the builders, Frontend) the same as the CLI.
  • docs/CI_GITHUB_ACTION.md: the composite action's recipes, version pinning and an inputs table; the name leaves room for a GitLab sibling.

The library detail stays on docs.rs instead of a fourth Markdown file. The crate docs gain a Features section (the default set, full, lean, and one line per remaining flag), and the live-reload module documents the web-modules:css-reloaded event, the symlink watcher caveat, and a hub-wiring doctest on LiveReload.

The README keeps the install block, the --help output, the builders example and the Pages deploy recipe, so the #github-actions anchor and its two in-page links survive. docs/ is not packaged into the crate, same as MAINTENANCE.md.

The README is an overview again (240 to 144 lines).

- docs/CLI.md: every build flag and its package.json key.
- docs/POLICIES.md: HTML policy, duplicate output paths, the output directory and the symlink modes; they bind the library (Processors, the builders, Frontend) the same as the CLI.
- docs/CI_GITHUB_ACTION.md: the composite action's recipes, version pinning and an inputs table; the name leaves room for a GitLab sibling.

The library detail stays on docs.rs instead of a fourth Markdown file.
The crate docs gain a Features section (the default set, full, lean, and one line per remaining flag), and the live-reload module documents the web-modules:css-reloaded event, the symlink watcher caveat, and a hub-wiring doctest on LiveReload.

The README keeps the install block, the --help output, the builders example and the Pages deploy recipe, so the #github-actions anchor and its two in-page links survive.
docs/ is not packaged into the crate, same as MAINTENANCE.md.
@gronke
gronke merged commit c17e0a5 into main Sep 4, 2026
9 checks passed
@gronke
gronke deleted the docs/readme-cli-actions branch September 4, 2026 15:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant