docs(adr): archive stale execution plans - #7761
Merged
Merged
Conversation
Generated from docs-tooling derive extraction + merge pipeline. Source: influxdata/docs-tooling reports/openapi/public/
Adds API reference entries for the two Enterprise storage-engine upgrade maintenance endpoints (parquet_cleanup, retry_parquet_to_pacha_tree) and CLI reference pages for the corresponding `influxdb3 manage` subcommands, which had no documentation. Also fixes two schema errors found while adding this content: the load capture profile's request-type field is named `type`, not `capture_type`, and its node identifier is a number, not a string. Adds the missing load capture profile detail, preview, and download reference entries, and adds a note about the upgraded storage engine requirement to the Parquet export endpoints. Corrects the resource token endpoint's description of InfluxDB 3 Cloud support.
The delete load capture profile endpoint and the corresponding
influxdb3 loadcap delete command didn't document that deleting a
profile while it's still capturing returns an error. Adds a 409
response to the API reference and a note to the CLI reference page.
Verified against a running InfluxDB 3 Enterprise 3.11.2 instance:
starting a capture and immediately deleting it by profile id returns
409 Conflict from both the HTTP API and the CLI ("a capture is already
in progress"); deleting again after the capture finishes succeeds.
What changed: - Generate shared README content for every discovered official plugin and backfill missing pages. - Preserve NWS capitalization in generated stubs and normalize generated Markdown for validation. Why: - Registry discovery previously created product stubs without article content for unmapped plugins. Impact: - Official plugin pages, including NWS Weather, now render generated article content in Core and Enterprise. Verification: - yarn test:sync-plugins - yarn lint-codeblocks content/shared/influxdb3-plugins/plugins-library/official/*.md content/influxdb3/core/plugins/library/official/*.md content/influxdb3/enterprise/plugins/library/official/*.md - npx hugo --quiet
What changed: - Compact canonical agent instructions and skill entrypoints, with routed references. - Add a changed-file verifier and enforced instruction size limits. Why: - Reduce baseline agent context while retaining targeted operational guidance. Impact: - Agents can plan focused manual validation without re-running commit hooks. Verification: - yarn test:verify-changed - yarn test:agent-instruction-limits - yarn build:agent:instructions - yarn validate:agent-instructions - git diff --check
What changed: - Removed completed and stale execution plans. - Preserved durable site architecture as three concise ADRs. Why: - Execution plans are not a durable archive, while the retained choices guide future site maintenance. Impact: - Repository decision history now distinguishes architecture from content and rollout history. Verification: - yarn verify:changed -- docs/adr/0005-agent-instruction-adapter-architecture.md docs/adr/0006-product-jsonld-rendering.md docs/adr/0007-release-version-drift-detection.md - .ci/remark/remark.sh docs/adr/0005-agent-instruction-adapter-architecture.md docs/adr/0006-product-jsonld-rendering.md docs/adr/0007-release-version-drift-detection.md --quiet - git diff --check
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.
Summary
Verification
$ node scripts/verify-changed.mjs docs/adr/0005-agent-instruction-adapter-architecture.md docs/adr/0006-product-jsonld-rendering.md docs/adr/0007-release-version-drift-detection.md
Detected: no supported files.
Commit hooks cover formatting, Vale, source-path checks, and instruction linting; CI covers broader link and render checks.
Deferred (unsupported in this release): docs/adr/0005-agent-instruction-adapter-architecture.md, docs/adr/0006-product-jsonld-rendering.md, docs/adr/0007-release-version-drift-detection.md.
No manual checks are currently selected.
Done in 0.30s.
Notes