Skip to content

Commit 503fe7b

Browse files
authored
Update to process text. (#15)
* Update to process text. * Fix text.
1 parent e09af05 commit 503fe7b

File tree

2 files changed

+10
-4
lines changed

2 files changed

+10
-4
lines changed

community/index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,10 @@ Pull requests are expected to be reviewed by the committers within 24 hours afte
4242

4343
Changes that add or modify syntax, language features, Slang's core module, or the compilation and reflection API must go through our process for language changes. The full process is [documented here](/community/language-change-process).
4444

45+
#### Updates for the Processes
46+
47+
The above processes can be updated to meet the changing needs of the Slang project. Updates to these processes can be made via pull request to the [Slang website repository](https://github.com/shader-slang/shader-slang.github.io) after community discussion and with PR approval by at least two Language Owners.
48+
4549
## Submitting a Pull Request
4650

4751
If you are ready to start contributing, please follow our [guide for creating a pull request](https://github.com/shader-slang/slang/blob/master/CONTRIBUTION.md). All pull requests are expected to meet our [bar of code quality](/community/code-quality).

community/language-change-process.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Changes that touch Slang's language and user-facing interfaces, including syntax, core module and public APIs need to follow the feature change process described in this document.
44

5-
Before undertaking the rest of the process, you are encouraged to pitch your idea on the Slang GitHub forum, in order to solicit informal feedback from the community. Feedback at this stage can help refine an idea, suggest directions, and identify potential collaborators.
5+
Before undertaking the rest of the process, you are encouraged to "pitch" your idea on the Slang GitHub forum, in order to solicit informal feedback from the community. Feedback at this stage can help refine an idea, suggest directions, and identify potential collaborators.
66

77
## File a Feature Tracker
88
The first step of doing a feature change is to file a "Feature Tracker" issue on our github with associated FeatureTracker label to begin including all template fields included. You will need to be a committer, or ask a committer or community member with greater access to the repo to do this, see [community structure](/community/index#community-structure) for how to do so.
@@ -21,10 +21,11 @@ Announce your intent to implement the feature in the [Announcement Channel in Gi
2121

2222
The Owners of docs/proposals (aka the "Language Owners") may weigh in on feature proposal issues to give guidance on what they expect will or will not be accepted as changes to the language.
2323

24-
If it is clear to the language Owners that a proposed feature will not be accepted, they may close out the issue with an explanation of the reasoning.
25-
Ideally, you should wait to get positive feedback from at least one language OWNER before moving forward with implementation, to avoid the possibility of wasted effort.
24+
If it is clear to the Language Owners that a proposed feature will not be accepted, they may close out the issue with an explanation of the reasoning.
25+
Ideally, you should wait to get positive feedback from at least one Language Owner before moving forward with implementation, to avoid the possibility of wasted effort.
26+
The Language Owners are responsible for making a decision on whether or not to proceed with implementation for all proposals to remove the ambiguity in the case of insufficient or mixed community feedback.
2627

27-
Assuming positive community support for your proposal, move your tracking issue's status to "experimental" and begin putting up PRs for reviews by relevant code Owners.
28+
With positive support for your proposal from the Language Owners, move your tracking issue's status to "experimental" and begin putting up PRs for reviews by relevant code Owners.
2829

2930
During the implementation period, you are expected to:
3031

@@ -47,3 +48,4 @@ At decision time, the Owners listed in `.github/CODEOWNERS` will discuss private
4748
We expect that between 3-7 days will be given for community feedback in typical cases. Some lived experience is needed before we can make a policy about how long review periods need to last.
4849

4950
The total time spent from creation of the tracking issue to when a feature is marked "stable" may vary with the complexity of a feature, but we expect that it will typically fall in the 1-3 month range. Even if a small feature might be proposed and implemented in a matter of days, it would need to be given sufficient time in the experimental state for community engagement and feedback before being considered for stabilization.
51+

0 commit comments

Comments
 (0)