Skip to content

docs: link problem statements instead of restating them - #5

Merged
olaservo merged 1 commit into
mainfrom
docs-sync-problem-statements
Nov 4, 2026
Merged

olaservo merged 1 commit into
mainfrom
docs-sync-problem-statements

Conversation

@olaservo

@olaservo olaservo commented Nov 4, 2026 •

Copy link
Copy Markdown
Member

Fast follow to #1. Docs only.

docs/problem-statements.md (#3) is now the source of truth for scope, open questions, and SEP status, so the skeleton docs link to it instead of restating it:

  • README: scope covers listing, search/glob, bulk/partial reads, writes, and stat (per PS1–6), and links the problem statements.
  • open-questions.md: keeps only cross-cutting questions (SEP-2571/2532 disposition, uploads vs. writes, Skills resources/directory/read) and links the PS items; per-statement questions live in the problem statements.
  • related-work.md: drops the SEP table, which had already drifted (SEP-2631 listed as Draft; it closed 2026-10-14), and points to PS "Related proposals". Adds the File Uploads extension.
  • use-cases.md: links the running example and PS1–3 for the two cases they already cover; memory-server and base64 cases unchanged.

AI disclosure: drafted with Claude Code; reviewed by me.

🤖 Generated with Claude Code

@olaservo
olaservo requested a review from a team as a code owner November 4, 2026 12:59
@olaservo
olaservo force-pushed the docs-sync-problem-statements branch from 92a07b6 to 5427441 Compare November 4, 2026 13:03
@olaservo olaservo changed the title docs: link problem statements instead of restating them docs: link problem statements from the skeleton and strawman Nov 4, 2026
@olaservo
olaservo force-pushed the docs-sync-problem-statements branch from 5427441 to 92a07b6 Compare November 4, 2026 13:08
@olaservo olaservo changed the title docs: link problem statements from the skeleton and strawman docs: link problem statements instead of restating them Nov 4, 2026
jayzuccarelli
jayzuccarelli previously approved these changes Nov 4, 2026

@jayzuccarelli jayzuccarelli left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thanks Ola, this reads right. Linking the problem statements instead of restating them keeps one source of truth, and the PS4–PS6 items you added are ones the strawman should carry. LGTM.

- README scope now matches the problem statements (listing, search, bulk/partial reads, writes, stat)
- open-questions keeps only cross-cutting questions and links PS items
- related-work drops its SEP table (already stale on SEP-2631) and points to PS "Related proposals"; adds File Uploads extension
- use-cases links the running example and PS1-3 for the overlapping cases

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@olaservo
olaservo dismissed jayzuccarelli’s stale review November 4, 2026 14:10

The merge-base changed after approval.

@olaservo
olaservo force-pushed the docs-sync-problem-statements branch from 92a07b6 to 6b7e716 Compare November 4, 2026 14:10
@olaservo
olaservo merged commit 6f9daa1 into main Nov 4, 2026
@olaservo
olaservo deleted the docs-sync-problem-statements branch November 4, 2026 14:13
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.

2 participants