Skip to content

Draft version of design agreements summary#67

Open
marcpaterno wants to merge 10 commits into
mainfrom
create-design-agreements-summary
Open

Draft version of design agreements summary#67
marcpaterno wants to merge 10 commits into
mainfrom
create-design-agreements-summary

Conversation

@marcpaterno
Copy link
Copy Markdown
Member

This adds a "design agreements summary", collected from Github issues and Github discussions.

Copilot AI review requested due to automatic review settings May 27, 2026 20:07
@marcpaterno marcpaterno requested a review from knoepfel May 27, 2026 20:07
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR adds a draft top-level design-agreements summary for Phlex, collecting agreement-like decisions from related GitHub issues and organization discussions and organizing them by subsystem.

Changes:

  • Adds a new Markdown document summarizing design agreements, caveats, and tensions.
  • Cross-references relevant Phlex subsystem design documentation and source issue/discussion threads.
  • Identifies unsettled contradictions around product-query semantics and hierarchy/layer knowledge.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread design_agreements.md
@knoepfel
Copy link
Copy Markdown
Member

knoepfel commented Jun 1, 2026

@marcpaterno, I made some changed with commit e06cd86 (just removing unnecessary content, and renumbering lists accordingly)

marcpaterno and others added 8 commits June 2, 2026 09:48
Rename the supporting-design chapter directory from
ch_subsystem_design to ch_technical_design to align the
documentation with technical-design terminology.

Update toctrees, Sphinx exclude patterns, and cross-references
from conceptual design and appendix requirements so the moved
chapter and its sections continue to resolve correctly.
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.

4 participants