docs: full documentation pass for the v1.3.0 feature/hardening batch#111
Merged
Conversation
Add an unreleased v1.3.0 CHANGELOG section covering nine merged changes: singular alias forms (#6), --workers on bulk writes (#3), dynamic shell completion (#2), audit_redaction: full (#5), and the CI/supply-chain and state-root hardening (#90, #9, #12, #16, #4). Update the README writing, completion, audit, and a new curated-aliases section, and mirror the four user-facing features into the docs site home highlights. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- concepts/first-run: curated singular aliases (device == devices) - install: dynamic TAB completion from cached schema - writes-and-safety: --workers N (default 1, max 32) for parallel bulk writes - ci-and-automation: faster bulk loads via --workers with rate-limit caution Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Document the nine just-merged changes across the skill, contributor, and architecture docs: - --workers N (default 1, max 32) for bulk writes: SKILL.md write patterns and http-client.md (ThreadPoolExecutor over sync httpx, serialized audit append lock). - Dynamic shell completion (nsc/completion/): component listing in overview.md, cache-backed at TAB time in caching.md, TAB hints in SKILL.md and managing-profiles.md. - Curated singular aliases + cross-tag/plugin alias resolution noted in working-with-plugins.md; SKILL.md verified consistent. - audit_redaction: full mode (5-key, sanitized url) in http-client.md and SKILL.md; default stays safe. - ~/.nsc clamped to 0700 via shared ensure_private_dir() in http-client.md. - CI: e2e matrix over NetBox 4.5/4.6, Node 24 runners, least-privilege permissions, Dependabot for github-actions in development.md. - CLAUDE.md cheat sheet gains nsc/completion/ entry. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…l-contrib' into docs/phase6-pass
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Full documentation pass reflecting the nine Phase-6 changes merged into
main(issues #2, #3, #4, #5, #6, #9, #12, #16, #90).What changed
## v1.3.0 — unreleasedsection (Added: singular aliases,--workers, dynamic completion,audit_redaction: full; Changed:~/.nsc0700, Node 24, workflow permissions, release SHA pins + Dependabot, e2e 4.5/4.6 matrix), with footnote issue links.--workersexample, dynamic-completion examples,audit_redaction: fullnote, a "Curated aliases" section; retired the now-shipped "post-1.0 roadmap" notes.writes-and-safety(--workers),ci-and-automation(faster bulk loads + rate-limit caution),install(dynamic completion),concepts/first-run(singular aliases),managing-profiles(--profile <TAB>),working-with-plugins(cross-tag alias resolution).audit-log.mdalready coveredfullmode (verified, untouched).http-client(concurrency + audit-append lock, redaction modes,ensure_private_dir0700),overview+caching(newnsc/completion/package, cache-backed completion).development(e2e 4.5/4.6 matrix, Node 24, least-privilege permissions, Dependabot).--workers, TAB completion,audit_redactionsafe/full.nsc/completion/to the architecture cheat sheet; AGENTS.md regenerated from it.Validation
gen_docs.py --checkandsync_agents_md.py --checkboth green (auto-generated reference + AGENTS.md fresh).mkdocs build --strictpasses (no broken links/nav).pyprojectchanges;audit-log.mdreference docs untouched.Version bump + date for
v1.3.0are intentionally left for the separate release step.