-
Notifications
You must be signed in to change notification settings - Fork 2.4k
Update CONTRIBUTING.md #2477
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
Update CONTRIBUTING.md #2477
Conversation
What do you think about an updated file with an added a header with language from https://github.com/apple/swift?tab=readme-ov-file#contributing-to-swift ? Also added some headers for pull requests and a paragraph about the repo + highlighting the forums as the main place for conversation.
CONTRIBUTING.md
Outdated
Substantive changes to: | ||
- existing proposals should only be made with the permission of the proposal authors. Substantive changes to a proposal in the Accepted or Rejected states are discouraged and require the approval of the appropriate evolution workgroup. Substantive changes to a proposal in the Active Review state require the approval of the appropriate evolution workgroup and should be advertised in the review thread. | ||
- change vision documents require the approval of the appropriate evolution workgroup. | ||
- documented evolution process require the approval of the Core Team. |
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 found this hard to read when the new text separates the verb from its object across bullet points. It forces you to be inconsistent in the first bullet, since there's more than one sentence.
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.
@amartini51 agreed after re-reading it with your comment in mind. I added the verb back. What do you think? thanks for you review
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.
@amartini51, @rjmccall had another suggestion below that I merged in. Let me know your thoughts for the latest copy.
Co-authored-by: John McCall <[email protected]>
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.
LGTM
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.
Thank you!
What do you think about an updated file with an added a header with language from the /swift repo?
Also added some headers for pull requests and a paragraph about the repo + highlighting the forums as the main place for conversation.
None of the process language was changed. Mostly reformatting to style.