docs: clear the remaining error-level vale lints
Per #4128 (mara: allow-everywhere false positives go in a central list, otherwise fix in source). Testing surfaced better fixes than the plan posted on the issue: - 5x Microsoft.Contractions 'that is' idiom false positives: adding the missing comma ("that is, ...") both reads better and satisfies the rule's own negative-lookahead, so no suppression is needed at all. Fixed in docs/integrations/forge.md, docs/tools/forge.md, docs/tools/hivectl.md, docs/web-ui/dashboard.md, and swarmctl-cli.md's generated source (swarmctl/src/main.rs, doc comment regenerated via markdown-docs). - persistence.md's 'is not' matching inside 'is nothing': reworded to 'there'\''s nothing' rather than add any exception -- dodges the trap and is a genuine contraction besides. - ca.md's 'it is' matching inside the already-correct 'it isn'\''t': tried a central .vale.ini TokenIgnores entry first per the allow-everywhere framing, but testing against the real file (not just a synthetic snippet) found it silently fails to suppress whenever markdown emphasis syntax appears earlier in the same file -- an offset-drift bug in how Vale applies TokenIgnores, not a config mistake. Reworded to "it'\''s not" instead, same fix shape as persistence.md. - config.md's 3 genuine Microsoft.Avoid 'backend' exceptions (already flagged and accepted on #4139 -- an actually-pluggable LLM API provider, matching the nix option's own name, not one internal system to name): scoped inline vale suppression around just that section, since this one really is context-specific rather than a rule bug. Verified: fresh 'vale docs/ --minAlertLevel=error' is 0 errors AND 0 warnings (was 10 errors). nix fmt 0 changed beyond the edits themselves. pre-push lints (tracker-tag/comment-block/doc-pointer) clean. cargo clippy -p swarmctl -- -D warnings clean. Diffed the regenerated swarmctl-cli.md against the old copy to confirm only the intended line moved.
This commit is contained in:
parent
a4f72365c7
commit
f22791b7a4
9 changed files with 18 additions and 10 deletions
|
|
@ -58,8 +58,8 @@ struct PathArgs {
|
|||
/// rather than whatever is on `PATH`.
|
||||
#[arg(long, value_name = "PATH")]
|
||||
authelia_bin: Option<PathBuf>,
|
||||
/// Host-side path of authelia's users database — that is the path inside
|
||||
/// the container, prefixed with the container's root.
|
||||
/// Host-side path of authelia's users database — that is, the path
|
||||
/// inside the container, prefixed with the container's root.
|
||||
///
|
||||
/// This is the only user store: it's read before every change and
|
||||
/// written in place, and `swarm-authelia-bridge` writes the same file.
|
||||
|
|
|
|||
Loading…
Reference in a new issue