-
Notifications
You must be signed in to change notification settings - Fork 2.5k
Restructure the evolution process documentation #2953
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
rjmccall
wants to merge
2
commits into
swiftlang:main
Choose a base branch
from
rjmccall:process-update
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+301
−112
Conversation
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
b4e8d8c to
7f452d9
Compare
ktoso
approved these changes
Sep 17, 2025
FranzBusch
reviewed
Sep 19, 2025
FranzBusch
approved these changes
Sep 19, 2025
xedin
reviewed
Sep 21, 2025
stmontgomery
approved these changes
Oct 7, 2025
Contributor
stmontgomery
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think there's one small formatting issue outstanding (#2953 (comment)) but broadly speaking this is a great improvement to the process docs, thanks!
011c702 to
18f6a03
Compare
…ion. - Generalized some of the early wording to not just talk about the language and standard library - Moved the list of covered evolution areas from the Scope section to a later and more comprehensive Evolution Areas section - Unified the discussion about what is and is not covered by the evolution process into the early "scope" section - Changed some of the wording around when bug fixes are effectively design changes - Turned the Community Structure section into an Evolution Workgroups section: - Moved earlier in document. - Removed list of specific workgroups (now covered comprehensively by Evolution Areas). - Added brief discussion of Core Team delegation. - Added text giving workgroups authority for deciding how the process applies in their area. - Added text describing how cross-area proposals should be managed. - Added an Evolution review section: - Added a quick summary of the review process (proposal development + open review). - Permit summary judgments, with caution. - Greatly expanded Participation section: - Added extensive guidance for participating in review. - Moved "How to Propose a Change" section into this section. Extensively reworded guidelines. - Moved discussion of focus areas to a separate section near end of document. - Added Evolution Areas section: - Describes three existing evolution areas, their workgroups, and the details of the evolution process used in each area - Fixed the description of package manager proposals, which the current document still assigns to the PSG instead of the ESG. - New Focus Areas section: - Removed from proposal guidance - Weakened wording to reflect actual practice - Changes to final sections of interest primarily to workgroups: - Moved the proposal status flowchart into this section - Added a section about generic proposal document structure: required fields, etc.
18f6a03 to
a696a02
Compare
FranzBusch
approved these changes
Nov 20, 2025
xwu
reviewed
Nov 20, 2025
Co-authored-by: Xiaodi Wu <[email protected]>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Labels
evolution process
A change to the meta-content of evolution, e.g. the process documentation or templates
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.
The focus of this change is on generally fixing and improving the documentation. For now, I am specifically trying to avoid resolving questions like whether SPM proposals should be part of the SE namespace and whether all evolution reviews should share a common category on the forums. The goal there is to document the current evolution process; if an evolution workgroup changes its practice in the future, editing this file will be the way it officially documents its new process.
An earlier version of this PR also laid out a lightweight evolution review process. I have removed this from the PR, not because I am uninterested in adding it, but because I want to land the general documentation improvements separately.
Summary of changes: