Skip to content

docs: consolidate documentation and remove stale ADRs - #24

Merged
DavidHLP merged 1 commit into
mainfrom
codex/docs-convergence-20260918
Sep 18, 2026
Merged

DavidHLP merged 1 commit into
mainfrom
codex/docs-convergence-20260918

Conversation

@DavidHLP

Copy link
Copy Markdown
Owner

Summary

Consolidate the current documentation surface around one map and five topic owners, remove obsolete ADR/plans material, and remove stale ADR labels from source comments and tests.

Checklist

  • Documentation changes update the canonical owner in docs/README.md.
  • bash scripts/ci/check-docs-contracts.sh passes.
  • bash scripts/ci/check-test-names.sh passes syntax validation.
  • Public API/configuration/wire behavior is unchanged.
  • Commit message follows Conventional Commits.

Backward compatibility

  • Compatibility impact is documentation/internal-only.
  • Production Java behavior is unchanged; Java diffs are comments/Javadoc or test display names only.

Validation

  • bash -n scripts/ci/check-docs-contracts.sh
  • bash scripts/ci/check-docs-contracts.sh
  • bash -n scripts/ci/check-test-names.sh
  • bash -n scripts/ci/check-external-consumer.sh
  • bash -n scripts/ci/require-all-green.sh
  • git diff --cached --check
  • Markdown links: 17 files, 115 relative links, 0 issues
  • Formal ADR-, docs/adr, and docs/plans search is clean except for the intentional .gitignore rules.

@DavidHLP
DavidHLP merged commit 72ecfd0 into main Sep 18, 2026
10 checks passed

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 03d80a5083

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/REFERENCE.md
Comment thread README.md
@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-18T14:44:38.102326Z 03d80a5 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@DavidHLP
DavidHLP deleted the codex/docs-convergence-20260918 branch September 18, 2026 14:52
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