ISSUE-76: Requirement to document changes between CR publications

CR changelogs

Requirement to document changes between CR publications

State:
CLOSED
Product:
Document life cycle (pre 2014 chapter 7, now chapter 6)
Raised by:
Ian Jacobs
Opened on:
2013-12-12
Description:
Ian wrote in

In this section, one bullet is:

"If the document has previously been published as a Candidate
Recommendation, must document the changes since the previous
Candidate Recommendation, "

It is not clear to me how this differs from the general requirement:

"must provide public documentation of all substantive changes to
the technical report since the previous publication. The community
also appreciates public documentation of minor changes."

You might have something specific in mind, but as written I can't
determine the difference. Or if the difference is "documenting all
changes" instead of "documenting substantive changes" then I'm not
sure that difference is necessary to justify the specific bullet.
If the consensus ends up being that it is necessary, then I think the
difference from the general bullet needs to be clearer.

The difference is documenting *all* changes, vs a must for substantive and a should for other changes...

It is not clear that the difference is important enough to keep the special requirement.
Related Actions Items:
No related actions
Related emails:
  1. [minutes] and summary of 27 January 2014 Revising W3C Process Community Group Teleconference (from coralie@w3.org on 2014-01-27)
  2. w3process-ISSUE-76 (CR changelogs): Requirement to document changes between CR publications [Document life cycle (ch 7)] (from sysbot+tracker@w3.org on 2013-12-12)

Related notes:

Note that this is part of ISSUE-77 and a new issue to be raised clarifying how CRs can be revised.

Charles 'chaals' (McCathie) Nevile, 22 Jan 2014, 12:49:55

The resolution of this Issue is tied to Issue 77.

Steve Zilles, 27 Jan 2014, 16:42:53

[koalie]: tied to issue-77

27 Jan 2014, 16:42:53

CLOSED, comment accepted. Entry to CR currently, 5 Feb 2014 editor's draft, uses the General Requirements section for documenting changes.

Steve Zilles, 10 Feb 2014, 18:48:51

Display change log ATOM feed


David Singer <singer@apple.com>, Chair, Dominique Hazaƫl-Massieux <dom@w3.org>, Staff Contact
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <w3t-sys@w3.org>.
$Id: 76.html,v 1.1 2020/03/09 13:50:16 carcone Exp $