Skip to content
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

Introduce section on blocking changes #29

Merged
merged 38 commits into from
Nov 18, 2020
Merged
Changes from 2 commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
263b29a
Introduce section on blocking changes
codehag Jul 31, 2020
3587898
addreess wording concerns and merge stage 1 blockers with stage 2/3
codehag Aug 4, 2020
91fcf67
Update index.html
codehag Aug 27, 2020
75e4631
Update index.html
codehag Aug 27, 2020
e260466
Update index.html
codehag Aug 27, 2020
c88e182
Update index.html
codehag Aug 27, 2020
6795215
Update index.html
codehag Aug 27, 2020
21f59c2
address dan's comments
codehag Sep 7, 2020
c8a0b7d
address leo's comments
codehag Sep 7, 2020
5a3e3c1
address wycats concerns
codehag Sep 7, 2020
8871ee6
Update index.html
codehag Sep 8, 2020
437f4ab
Update index.html
codehag Sep 8, 2020
56841d9
Update index.html
codehag Sep 8, 2020
bd84701
Update index.html
codehag Sep 8, 2020
3c01005
Update index.html
codehag Sep 8, 2020
4771d7e
Update index.html
codehag Sep 8, 2020
83e3dab
Update index.html
codehag Sep 8, 2020
d53f436
Update index.html
codehag Sep 8, 2020
a7338fd
Update index.html
codehag Sep 8, 2020
d82a42d
Update index.html
codehag Sep 8, 2020
fd25155
Update index.html
codehag Sep 8, 2020
82332ad
Update index.html
codehag Sep 8, 2020
4cd8844
Update index.html
codehag Sep 8, 2020
21d8ce4
address dan's comments
codehag Sep 8, 2020
d9b4de9
Update index.html
codehag Sep 8, 2020
17ba2dd
remove 'well-stated' wording and just use 'reason' as it is clearer
codehag Sep 14, 2020
7402d6f
Update index.html
codehag Sep 16, 2020
bbb0549
address shu and waldemar's feedback
codehag Sep 20, 2020
b479c20
Merge branch 'process-changes-blocking' of https://github.com/codehag…
codehag Sep 20, 2020
6977d16
Update index.html
codehag Sep 21, 2020
758a2bd
try to reframe and split into sections
codehag Sep 21, 2020
d6b44d8
Merge branch 'process-changes-blocking' of https://github.com/codehag…
codehag Sep 21, 2020
d6448de
rearrange and remove unnecessary lines
codehag Sep 21, 2020
ef6e2f5
remove redundant sentence
codehag Sep 25, 2020
cfbf570
edit down full text
codehag Nov 4, 2020
7891363
try to consolidate text further
codehag Nov 6, 2020
4d752a2
address grammatical concern and wording (typically -> sometimes)
codehag Nov 14, 2020
86556ac
remove green boxes
codehag Nov 18, 2020
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,30 @@ <h2>Calls for implementation and feedback</h2>

<p>When an addition is accepted at the “candidate” (stage 3) maturity level, the committee is signifying that it believes design work is complete and further refinement will require implementation experience, significant usage and external feedback.

<h2>Withholding Consensus for Advancement</h2>

<p>During the discussion of a proposal, at any stage, any aspect may be discussed, including those outside of the scope of its current stage. A proposal’s advancement may not have consensus, and may be "blocked". A block is a forumated reason for why a proposal should not advance in it's present form. The committee does not have a concept of a rejected proposal.</p>
codehag marked this conversation as resolved.
Show resolved Hide resolved

<p>In withholding consensus for advancement, a reason should be stated either as a delay or as a block. If no reason is given, the objection is void for vagueness. In the case of a delay -- a delegate may need more time to consider a given aspect of a proposal. They may request additional time, or allow conditional advancement.</p>
codehag marked this conversation as resolved.
Show resolved Hide resolved

<p>Conditional advancement is time-limited, giving the person raising the block time to discuss with the champions and authors about their concerns. If a proposal has conditional advancement, an issue is opened on the proposal’s repository. If the issue is resolved, the proposal automatically reaches the next stage without further discussion by the committee. If the issue cannot be resolved, the proposal does not advance.</p>
codehag marked this conversation as resolved.
Show resolved Hide resolved

<p>A Block needs to be well described and recorded within the committee, so that in future meetings and future proposals we can learn from failed proposals, and have a good record of why they failed.</p>
codehag marked this conversation as resolved.
Show resolved Hide resolved

<p>Regardless of stage, the following types of blocks require the committee to reach consensus in order for the block to be valid: Blocks related to an earlier stage, Blocks which have been discussed at length by the committee and were resolved, and insufficently stated blocks.</p>
Copy link
Member

Choose a reason for hiding this comment

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

This is really confusing. I understand we are asking consensus for a reason that blocks a proposal from advancing. Some of the items are rather vague: "Blocks related to an earlier stage". I have some reference but only due to my experience at the committee, but it might need way more clarification for new comers.

The paragraph on like 190 might already solve the problem here.

I'd prefer if we rephrase this w/ something like "The committee might also request consensus for the reasons presented for blocking or delaying a proposal from stage advancement. Well stated reasons are expected to be objective, technical, and should provide an actionable plan whenever possible."

This suggested paragraph supports the following with connotation for well stated reasons.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I don't think " objective" works -- people will either consider their positions to be objective, or will be presenting a very valid subjective view, i.e., a member industry position. I reworked that sentence a bit, let me know what you think.


<p>Blocking criteria for reaching stage 1, 2 and 3 are not limited but should be weighed according to their stage. Proposals which have fulfilled the acceptance criteria may be blocked from advancement for any well stated reason.</p>

<p>Blocking criteria for reaching stage 4 are limited. Proposals which have fulfilled the acceptance criteria may not be blocked from advancement unless the block is related to implementation experience or the block identifies an issue or information which has not previously been discussed by the committee. The reason stage 4 blocking is limited is to allow implementers to invest in implementations, and maintain the significance of stage 3 in the process.</p>
Copy link
Contributor

Choose a reason for hiding this comment

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

+1


<h2>Reverting to Earlier Stages</h2>
codehag marked this conversation as resolved.
Show resolved Hide resolved

<p>At any point in the process, a proposal may be downgraded in its stage in the case that a well stated blocker identifies an earlier stage issue that was not considered. This process requires an issue to be raised, and committee consensus to downgrade to a more appropriate stage.</p>
codehag marked this conversation as resolved.
Show resolved Hide resolved

<h2>Scope of responsibility for Champions</h2>
codehag marked this conversation as resolved.
Show resolved Hide resolved

<p>Champions are trusted to resolve smaller issues on their own without reference to the committee. Such issues are `nits` and can be raised at committee or as issues on github. Examples of `nits` are issues of taste such as naming.</p>
codehag marked this conversation as resolved.
Show resolved Hide resolved

<h2>Test262 tests</h2>

<p>During stage 3, <a href="https://github.com/tc39/test262">test262</a> tests should be authored and submitted via pull request. Once it has been appropriately reviewed, it should be merged to aid implementors in providing the feedback expected during this stage.
Expand Down