Skip to content

docs: add domain context documentation#85

Merged
brenpike merged 5 commits into
mainfrom
docs/domain-context-documentation
May 15, 2026
Merged

docs: add domain context documentation#85
brenpike merged 5 commits into
mainfrom
docs/domain-context-documentation

Conversation

@brenpike
Copy link
Copy Markdown
Owner

Summary

Adds domain context documentation following a multi-context structure with a root context map and per-project glossaries. Each glossary defines canonical domain terms, avoid-aliases, relationships, example dialogue, and flagged ambiguities per the plan-interrogation skill's CONTEXT-FORMAT.md reference.

Codex local review identified two inaccuracies (Core dependency description and collection cardinality) which were corrected before PR submission.

Files

STEP-001 — Create domain context documentation

  • CONTEXT-MAP.md (new) — root context map referencing three bounded contexts
  • src/Chatter.Rest.Hal/CONTEXT.md (new) — HAL domain and serialization glossary
  • src/Chatter.Rest.Hal.Core/CONTEXT.md (new) — shared kernel glossary
  • src/Chatter.Rest.Hal.CodeGenerators/CONTEXT.md (new) — code generation glossary

Validation

  • dotnet test: Not run (dotnet SDK not available in environment; changes are documentation-only markdown files with no impact on compiled code)

Version / Release

  • Not required (all changed files are .md, excluded from bump-trigger paths)

Constraints

  • Only project-specific domain terms included; no general programming concepts
  • CONTEXT.md files are glossary-only; no implementation details or specs

Open questions

  • None

Copy link
Copy Markdown

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

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: 6b3ca95f98

ℹ️ 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 CONTEXT-MAP.md Outdated
Comment thread src/Chatter.Rest.Hal/CONTEXT.md Outdated
Copy link
Copy Markdown

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

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: 1aa0f725f6

ℹ️ 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 CONTEXT-MAP.md Outdated
Comment thread src/Chatter.Rest.Hal/CONTEXT.md Outdated
@brenpike brenpike merged commit 600650f into main May 15, 2026
14 checks passed
@brenpike brenpike deleted the docs/domain-context-documentation branch May 15, 2026 18:37
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