docs: prioritize Linux, de-emphasize macOS/Windows#221
Draft
matt-dz wants to merge 4 commits into
Draft
Conversation
v0 primarily targets Linux. Update AGENTS.md Platform Support and docs/RULES.md to make this explicit so reviewers stop blocking PRs on hypothetical macOS or Windows breakage. Replace the Cross-Platform Compatibility block (with its Windows/macOS/Unix subsections) with a concise Linux-first Platform Targeting section, and trim related references and Windows-specific test-field guidance. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Reword the platform targeting language to avoid referring to a "v0" milestone, since the policy is simply that Linux is primary and other platforms are not prioritised at the moment. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
matt-dz
changed the title
The previous commit removed too much useful cross-platform guidance. Restore the original Cross-Platform Compatibility section and Sources links, and add only a one-line note at the top stating Linux is the primary target and macOS/Windows are not prioritised for now. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Revert the prior trimming of this bullet — the framework feature is real and the original documentation is the right place for it. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
AlexandreYang
requested changes
May 5, 2026
Member
AlexandreYang
left a comment
AlexandreYang
left a comment
There was a problem hiding this comment.
Hum, I think we should keep cross-platform parity as much as possible.
I think we shouldn't phrase it as one platform is more primary or important than others (as much as possible).
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
2 participants
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.
What does this PR do?
Updates
AGENTS.mdanddocs/RULES.mdto make Linux the primary target and explicitly de-prioritise macOS/Windows compatibility guidance.AGENTS.mdPlatform Support: rewritten to state Linux is the primary target; macOS/Windows are not prioritised for now and compatibility on those platforms is best-effort.AGENTS.mdTesting: trimmed Windows-specific assertion-field guidance — the framework fields still exist but should not be added proactively.docs/RULES.mdCross-Platform Compatibility: added a one-line note at the top stating Linux is the primary target and reviewers should not block PRs on hypothetical macOS/Windows breakage. The existing guidance below is preserved as good practice.Motivation
rshell primarily targets Linux, and macOS/Windows are not prioritised at the moment. Reviewers have been routinely flagging "this may not work on macOS/Windows" in PRs, which generates noise and blocks work that is correct for the actual target. Setting an explicit priority note in the agent docs gives reviewers a clear basis to stop blocking on hypothetical cross-platform breakage.
Testing
Documentation-only change; no code or tests touched.
Checklist