This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 21806 - Editors' response could be simplified
Summary: Editors' response could be simplified
Status: NEW
Alias: None
Product: HTML WG
Classification: Unclassified
Component: working group Decision Policy (show other bugs)
Version: unspecified
Hardware: PC All
: P2 normal
Target Milestone: ---
Assignee: This bug has no owner yet - up for the taking
QA Contact: HTML WG Bugzilla archive list
URL: http://www.plam.cantech.bg
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-04-23 23:30 UTC by Robin Berjon
Modified: 2015-02-16 00:36 UTC (History)
5 users (show)

See Also:


Attachments

Description Robin Berjon 2013-04-23 23:30:29 UTC
Given the new cool URL we have, I suggest that we simplify the boilerplate to the following:

"""
EDITOR'S DECISION (see http://dev.w3.org/html5/decision-policy/decision-policy.html on how to respond to it if needed)

(rationale)
"""

If implemented, I don't believe that this change will require a version change.
Comment 1 Sam Ruby 2013-05-15 14:06:02 UTC
I'd prefer EDITOR's RESPONSE rather than EDITOR'S DECISION, as many confuse Editor's proposed resolutions as Working Group Decisions.

I'd prefer a more specific URL, something like

http://dev.w3.org/html5/decision-policy/decision-policy.html#basic-step-2

And perhaps to make it even more stable, changing the anchor to #editors-response.

---

As to how the decision policy itself would need to change, clearly the boilerplate would have to be removed, the description of the resolutions can stay, and the part of the boilerplate that talks about potential next steps becomes part of the text of the decision policy.  What needs to be discussed is the following bullets:

 * A clear statement of whether the comment was accepted or rejected.
 * A rationale for the change or lack of change (at least enough for the Disposition of Comments).
 * A link to the relevant spec diff or diffs, if the spec was changed.

The proposed boilerplace covers #2, but doesn't clearly cover #1 and #3.  My take is that these are reasonable items for people to expect in a proposed resolution.  Thoughts?
Comment 2 Robin Berjon 2013-05-21 12:48:44 UTC
(In reply to comment #1)
> I'd prefer EDITOR's RESPONSE rather than EDITOR'S DECISION, as many confuse
> Editor's proposed resolutions as Working Group Decisions.

That's actually what I meant, thanks for catching that.

> I'd prefer a more specific URL, something like
> 
> http://dev.w3.org/html5/decision-policy/decision-policy.html#basic-step-2
> 
> And perhaps to make it even more stable, changing the anchor to
> #editors-response.

That works for me; I don't have a strong preference as the anchor name.

> As to how the decision policy itself would need to change, clearly the
> boilerplate would have to be removed, the description of the resolutions can
> stay, and the part of the boilerplate that talks about potential next steps
> becomes part of the text of the decision policy.  What needs to be discussed
> is the following bullets:
> 
>  * A clear statement of whether the comment was accepted or rejected.
>  * A rationale for the change or lack of change (at least enough for the
> Disposition of Comments).
>  * A link to the relevant spec diff or diffs, if the spec was changed.
> 
> The proposed boilerplace covers #2, but doesn't clearly cover #1 and #3.  My
> take is that these are reasonable items for people to expect in a proposed
> resolution.  Thoughts?

How about making it:

(Accepted|Rejected)
(Rationale)
(Pointer to change)

?