diff --git a/standards-track b/standards-track deleted file mode 160000 index 50c3464..0000000 --- a/standards-track +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 50c34649b7582a08e4072cc5377465e21f15e4fc diff --git a/standards-track/ChangeLog.txt b/standards-track/ChangeLog.txt new file mode 100644 index 0000000..354b055 --- /dev/null +++ b/standards-track/ChangeLog.txt @@ -0,0 +1,44 @@ +Change log 1/26/2016 + +Based on AB and other feedback, I've tried to explain the rationale for drafting this document. + +###Comment #1 Purpose first paragraph - "This document lists criteria to consider when evaluating proposals to move specification work to the W3C Recommendation track." + +In the text that follows it isn't clear whether this is about not allowing a deliverable to be listed in a proposed Charter or whether it means not allowing a deliverable to be published as a FPWD. "evaluating proposals to create new Working Groups or rechartering existing Working Groups to put new work in scope" implies the former while "Chairs when determining whether to publish First Public Working Drafts" implies the latter. + +Is this about restricting what types of specs are permitted by the Charter or is it about what has to happen before a WG is permitted to undertake work on a spec that is permitted? + +"when reviewing charters and Proposed Recommendations" is at the end of the REC track, so doesn't seem to be related to decisions on moving to the REC track – it’s already on the REC track – maybe this also includes criteria for more than what is in the first sentence.. + + +###Comment #1 Purpose first paragraph - "This document lists criteria to consider when evaluating proposals to move specification work to the W3C Recommendation track." + +In the text that follows it isn't clear whether this is about not allowing a deliverable to be listed in a proposed Charter or whether it means not allowing a deliverable to be published as a FPWD. "evaluating proposals to create new Working Groups or rechartering existing Working Groups to put new work in scope" implies the former while "Chairs when determining whether to publish First Public Working Drafts" implies the latter. + +Is this about restricting what types of specs are permitted by the Charter or is it about what has to happen before a WG is permitted to undertake work on a spec that is permitted? + +"when reviewing charters and Proposed Recommendations" is at the end of the REC track, so doesn't seem to be related to decisions on moving to the REC track – it’s already on the REC track – maybe this also includes criteria for more than what is in the first sentence.. + + + +#P1 - how is this applied to the many features in a proposed Charter? + +It is clear how this set of criteria apply in the WICG. Someone has a very specific proposal for one particular (often small) feature and they provide a bunch of evidence arguing it should transition to a WG. Is the idea that this to be done separately for every spec or every feature in the charter for a WG, like every feature or modification of a feature that the CSS WG will be permitted to work on? So if they have 15 new features in a recharter, they have 15 supplementary documents on how they meet the criteria? + +#P2 – what about hot topic WGs like Web Payments, IoT and W3C membership + +It seems fairly clear a WG like Web Payments wouldn’t come close to meeting these. I assume the same will be true for the upcoming IoT WG. Sometimes W3C seems to want a WG on a hot topic where the actual work could be done in an Interest Group. But an IG is viewed as not acceptable because potential members would not join just W3C for an IG. + +Should there be a new type of W3C WG for that? EWG – exploratory WG – nothing is REC track. It has an associated CG where it does incubator specs. You don’t get ultimate votes unless in the WG for whether to follow up in WG. + +#P3 – constant recharter churn? + +This increases the difficulty in getting specs into Charters. Charters are for 2 or 3 years. This would ban anything except work that has an incubator spec. Do incubator specs wait 2 years to the next recharter? Do the supergroups go into constant recharter mode? + +(the upcoming Hardware Security WG takes an approach to this problem where it has a “Restricted Scope” that it is allowed to produce specs on, but also may not – so it can add deliverables in that carefully described restricted scope) http://w3c.github.io/websec/hasec-charter + + +#P4 – long term impact on W3C – cg specs widely implemented get status + + + diff --git a/standards-track/bp.md b/standards-track/bp.md new file mode 100644 index 0000000..d3854d4 --- /dev/null +++ b/standards-track/bp.md @@ -0,0 +1,223 @@ +# Recommendation Track Readiness Best Practices + +## Status +Updated draft based on AC, AB, and GitHub comments + +Last updated on 2016/02/01 + +## Problem Statement +The practices proposed in this document are intended to address some specific problems: + +W3C wastes resources, and at worst tarnishes its credibility, when it invests in standardization efforts that end up going nowhere + + +## Overview of a Proposed Solution + +W3C should more tightly focus its +formal standardization effors on specifications that are most likely to get consensus within the consortium +and be used on the real Web. This document proposes to do that by offering a short list of criteria to consider when evaluating proposals to move specification work +to the Recommendation track. That includes drafting the Deliverables section of a WG charter, but especially when publishing a FPWD. + +These are offered as guidelines, not a checklist of required items in every proposal. +Meeting all the guidelines will not guarantee Director approval of the charter or FPWD, nor will failing to meet some block approval. *The goal +of this effort is to add more structure and predictability to Rec track decisions while allowing plenty of room for innovtion by +WGs and judgment by the Director.* + +The target audience for this document includes: +- the Team and Director and Advisory Committee when evaluating proposals to create new Working Groups or rechartering existing Working Groups to put new work in scope (e.g. how specs reach maturation before FPWD), and in reviewing Proposed Recommendations; +- working group Chairs determining whether to publish First Public Working Drafts of +specs that are in a group's chartered scope, + +This document attempts to strike a balance between two classes of criteria: +- "aspirational" considerations such as whether the spec addresses an un-met need or expands the potential of the Web +- "empirical" considerations such as whether drafts of the spec have momentum with implementers and early adopters + +Discussion at the [October 2015 Advisory Committee meeting](https://www.w3.org/2015/10/27-ac-minutes.html#item02) +indicated disparate opinions about whether to insist that proposed work should meet empirical criteria before being +put on the Recommendation track. + +Arguments raised in favor of mandatory incubation included: +- The "aspirational" approach often assumes that whatever a WG produces will be implemented, but WGs without a reality check from implementers tend to create specs that don't get used in the real world. +- Recommendation track documents that don't get implemented or widely used do not advance W3C's mission or enhance its reputation +- The industry overall is moving toward more data-driven decision making +- It's useful to identify *what* criteria are prerequisites for a Recommendation Track effort, but not to prescribe *how* those +criteria are to be met. So incubation in a CG is just one way to meet the criteria, not the only way. + - The Working Groups Process is not well suited to innovation of new ideas; the formal consensus process is most effective at "polishing" solid proposals to make them more clear, specific, and useful across users with different languages, cultures, and abilities. + - The REC track sometimes confers unwarranted legitimacy to proposals that do not have buy-in from the stakeholders needed get it to Recommendation and deployed on the real Web. + +Arguments against focused on mandating using W3C Community Groups to incubate proposals until they +met empirical criteria included: +- Incubation isn't a silver bullet to be applied to every situation +- If a CG incubates a spec that gets implemented in the browsers, it's hard to motivate proponents to take it to a WG for broad review +- Requiring external incubation in a venue that doesn't require broad consensus + could lead to key technical decisions being made in forums dominated by a few, + with "level playing field" discussion beginning only when implementation momentum makes change difficult. +- There may be gaps in the patent commitment if all spec contributors to the incubation don't join the WG +- It may be valuable for W3C team to help develop one or more proposals in the incubation stage + +The readiness criteria below outline best practices for finding an appropriate balance among these perspectives. +They encourage all involved in advancing work to the Recommendation track to gather more evidence to drive the decision and to think carefully +about how to interpret it. They do not mandate any one mode of gathering that evidence or an algorithm to assess it. + +##Readiness Criteria + +The criteria here are used to evaluate whether a technical specification development effort is +ready for the W3C Recommendation Track. No single factor is decisive, and this document avoids [RFC 2119](https://www.ietf.org/rfc/rfc2119.txt) "MUST" and "SHOULD" terminology, and should not be a taken +as a checklist of necessary or sufficient criteria. Nevertheless, some criteria are +noted as "strongly recommended", and, if not met, an explanation of why they don't apply in a particular situation would +facilitate the Director's decision. Different cases will involve different combinations of these factors. In determining whether to +approve moving work to the Recommendation track, the Director may consider +other factors not listed in this document as well. + +Assessing whether proposed work is likely to fulfull the W3C mission to [lead the web to its full potential](http://www.w3.org/Consortium/mission) +is the traditional criterion the Team and Director use to evaluate whether to start a working group or advance +a specification. While this is "aspirational", it requires +judgment that balances the future potential of the Web alongside the need for real developers to make the Web work in practice. +This document seeks to make the factors that go into this judgment +more explicit and generally applicable. + + +The "empirical" criteria are inspired largely by the experience of some open source browser projects +that use an [intent to implement](https://docs.google.com/document/d/1vlTlsQKThwaX0-lj_iZbVTzyqY7LioqERU8DK3u3XjI/edit#) process +to build the case for shipping +a new feature. This document refines this approach to apply to Recommendation +Track transition decisions. +The [Web Platform Incubator Community Group](https://www.w3.org/community/wicg/) has adopted +something similar to [determine when a spec under incubation is ready to propose to a +Working Group](https://wicg.github.io/admin/intent-to-migrate.html). + +### Is there a clear problem statement? +*Strongly Recommended*: The proposal identifies the real-world problem this work would address, and why existing solutions are inadequate. +What are web developers forced to do without this feature being available in a standardized way? +What fraction of web sites, hybrid applications, data publishers, etc. are using a similar capability in a non-standardized way? +How would users benefit from this feature if standardized? + +### Are success criteria explicit? +*Strongly Recommended*: The proposal enumerates the types of products (browsers, servers, frameworks, applications...) would need to +support the spec for it to be +successful, and indicate what degree of critical mass would be needed. +Is this spec serving a specialized community and only that community needs to implement and adopt it for it to be successful? +Or are there critical ecosystem dependencies, e.g. the spec must be deployed on both +the cloud/server and browser/client, +or must be supported both in products for producers and consumers of web content, to be really useful? + +### Is there a well-socialized proposal to address the problem? +*Strongly Recommended*: An initial draft of the technical specification has been written down and socialized in a community where potential users, web site / app +developer, framework/took developer, and core technology implementers are represented. +The state of community consensus around the initial draft should be documented: Did potential users and key implementers actively participate +in the discussion? Are there any indications that social or economic pressure was applied to suppress dissent? Did the discussion generate sustained expressions of opposition or unwillingness to implement / use / make patent +commitments from key stakeholders? If there are indications that consensus in a WG will be difficult to achieve, proposers are well advised +to make a persuasive case for how the proposed Recommendation Track work can be successful. + +### Has the proposed spec been incubated to reasonable maturity? +*Strongly Recommended*: Charters do not list specs as deliverables, and WGs do not publish FWPDs, until there is +rough consensus across stakeholders that the spec solves a real problem, is likely to be implemented, and is likely to +be used on the Web. This consensus could emerge from an incubation phase in WICG or another CG, or in a WG that has an established +culture of taking and vetting suggestions from its public mailing list. + +The language in the +[Web Platform WG charter](http://w3c.github.io/charter-html/group-charter.html#deliverables) describes a one community's practice: +> The Working Group will not adopt new proposals until they have matured through the Web Platform Incubator Community +Group or another similar incubation phase. + +If work is incubated in a CG, it is important to assess the degree of consensus behind a spec as well as its maturity. +While CG's are not required to work by consensus, those proposing work for the Recommendation track should favor proposals that +did get strong and broad consensus during the incubation phase, and make W3C staff aware of points of contention, rival proposals, etc. An optional [W3C Community Group Charter Template](https://github.com/w3c/cg-charter/blob/gh-pages/CGCharter.html) contains provisions designed to promote fairness in CGs. CGs are encouraged to consider using the template as a starting point. + +The key word is "matured", and the key milestone is First Public Working Draft (FPWD). It may be inefficient to charter WGs that start with +a "blank sheet of paper" or multiple proposals with different use cases, but it hurts W3C's credibility to +publish a formal Technical Report that specifies a technology that does NOT meet clear user needs in a way that has a good chance to be implemented in products, tools, websites, +and web applications. However the incubation phase is done, and whichever of these criteria are applied before proposing standardization +or developing a charter,this document strongly recommends that only "mature" specs be published as FPWDs. + +### Is it clear the proposers are not seeking a rubber stamp from W3C? +*Strongly Recommended*: Proposers of Recommendation-track work should be prepared for the Working Group to +make substantive changes to the initial draft in response to feedback. A W3C Recommendation signifies that a specification has broad consensus across the membership of W3C. It is particularly important to ensure that a spec both serves a real mainstream need +*and* is inclusive of a diverse, worldwide community using different languages, with various levels of ability, and +who interact with various levels of trust. Likewise, proposed Recommendation-track work should not promote +the interests of one group of members at the expense of another, e.g. taking sides in a product-driven "standards war." + +### Are there appropriate expressions of interest? +The proposal points to statements of support from key stakeholders about the value proposition for the feature +it describes. Is there strong demand from potential users? Is there a critical mass of implementers tentatively interested in shipping this feature +if standardized? Are there prototype / polyfill implementations that are used in experimental apps / sites +that the target audience already finds useful? + +### Is there actual evidence to back up the answers? +The proposal describes what implementation and user experience is there to back up the points above. +What fraction of websites are implementing a similar feature in a non-standardized way? +How many users would potentially benefit from this feature if standardized? +Hard data is preferred, but estimates backed up by detailed explanations are acceptable. + +### Risks? +The proposal considers whether standardizing the spec could create more problems than it solves. +What are the potential downsides of having this feature standardized ...could it undermine security, privacy, accessibility, etc. +if broadly deployed? Are there scenarios under which we would regret standardizing this feature? + +### Is the timing right? +The optimal timing for a transition to the Recommendation Track can be described as: +- NO SOONER than the bulk of the criteria above are met. +- NO LATER THAN a point where the spec is still fluid, and not frozen into shipping code used on many websites. + +If the answer “the ship has sailed”, proposers should explain how they propose to mitigate the situation without turning back the clock, +and what a Recommendation Track document could do to improve the situation. For example, clearly documenting what already interoperates, +and getting broader patent commitments on the interoperable behavior arguably has value. + +### Clear RF licensing commitments? + +W3C seeks to issue Recommendations that can be implemented and used on a +[Royalty-Free](http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Requiremenst) basis. +1. Are the technologies in the initial available under terms that are compatible with the +[W3C Royalty-Free licensing requirements](http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Requirements)? +2. Have those who seem most likely to have relevant patents made commitments to license them on +royalty-free terms? +3. Is the provenance of substantive contributions to the draft reasonably clear? + +### Team Engagement? +It is advisable for groups considering Recommendation Track work to consult with the W3C +Team early enough in the process for them to advise about potential problems and workarounds, and help draft a formal proposal. + +Working Groups and Interest Groups have Team Contacts they can use for this purpose. Community Groups generally do not (see [Team support for CGs](https://www.w3.org/2016/04/cg-support/)), but CG participants are encouraged to reach out to the [W3C staff](http://www.w3.org/People/) well in advance of proposing a transition to the Recommendation Track. + +##Process Considerations + +Discussion about these guidelines has generated a number of questions about how they relate to the W3C process and the Team's existing practices. +They are out of scope for this document, but they are listed for reference: + +###Granularity +Should the considerations above be applied at at the specification level or the feature level? + +###Charter Scopes and Deliverables +When chartering a new WG, is it appropriate to put in scope a number of features that are mostly "aspirational" and put in the deliverables +section only those that meet most of the criteria above? + +When an incubator spec is ready to move to a WG, does it wait (possibly a couple of years) +to get into a WG Charter or are is the expectation that WGs would re-charter to take on incubated spec proposals? + +Or is the best practice to make the *scope* of charters broad enough to encompass work that may be incubated during +the charter's lifetime, and the WG would only take up an actual deliverable once it is incubated? + +###Community Groups and the W3C Process +How can we ensure that concerns raised at the TPAC 2015 AC meeting and the AC Forum thread on Mandatory Incubation are addressed +in the process or practice of W3C? + +Should the Process Document describe a role for CGs in getting specifications ready to be standardized? Should the Community +and Business Group Process say more about the importance of working by consensus, at least for specifications that +are to be proposed for the Recommendation Track? + +###What to do when there is interest from users but not implementers? +Raised in the [AC discussions](https://lists.w3.org/Archives/Member/w3c-ac-forum/2016JanMar/0013.html). +Should the Process Document do more to describe a role for Interest Groups in developing use cases for new Recommendations, +and perhaps working in tandem with one or more Community Groups to develop credible technical proposals to address those +use cases? + + +##Conclusion +The criteria above suggest that Recommendation Track work begin when there are satisfactory answers to 3 basic questions: +- Does the work address a real un-met need or missed opportunity for the Web? +- Does the work start from a concrete proposal that has been socialized with key stakeholders but doesn't discriminate against others? +- Does standardizing the proposed spec have clear support from those who would need to implement and use the spec for it to be successful? + + + + diff --git a/standards-track/index.html b/standards-track/index.html new file mode 100644 index 0000000..850f085 --- /dev/null +++ b/standards-track/index.html @@ -0,0 +1,324 @@ + + + + + W3C Recommendation Track Readiness Best Practices + + + + + + + + + + + +
+

Also On This Page →

+ +
+
+

Nearby

+ +
+
+

+ Status +

+

October 2023: Document updated to account for changes in Process 2023, in particular the Director-free changes.

+

August 2016: This document was developed by a task force of the W3C Advisory Board, socialised to the W3C Advisory Committee and W3C Team.

+

This document lives in Github, where changes can be tracked and pull requests are welcome. + Feedback and comments are welcome. Please use Github issues.

+

+ Problem Statement +

+

The practices proposed in this document are intended to address some specific problems:

+

W3C wastes resources, and at worst tarnishes its credibility, when it invests in standardization efforts that end up going nowhere

+ +

+ Overview of the Proposed Solution +

+

W3C should more tightly focus its +formal standardization effors on specifications that are most likely to get consensus within the consortium +and be used on the real Web. This document proposes to do that by offering a short list of criteria to consider when evaluating proposals to move specification work +to the Recommendation track. That includes drafting the Deliverables section of a WG charter, but especially when publishing a FPWD.

+ +

These are offered as guidelines, not a checklist of required items in every proposal. + +Meeting all the guidelines will not guarantee the W3C decision for approval of the charter, or advancement to FPWD, nor will failing to meet some block approval. The goal +of this effort is to add more structure and predictability to Rec track decisions while allowing plenty of room for innovtion by +WGs and determination of W3C Decisions.

+ + +

The target audience for this document includes:

+ + + +

This document attempts to strike a balance between two classes of criteria:

+ + + +

Discussion at the October 2015 Advisory Committee meeting +indicated disparate opinions about whether to insist that proposed work should meet empirical criteria before being +put on the Recommendation track.

+ +

Arguments raised in favor of mandatory incubation included:

+ + + +

Arguments against focused on mandating using W3C Community Groups to incubate proposals until they +met empirical criteria included:

+ + + +

The readiness criteria below outline best practices for finding an appropriate balance among these perspectives. +They encourage all involved in advancing work to the Recommendation track to gather more evidence to drive the decision and to think carefully +about how to interpret it. They do not mandate any one mode of gathering that evidence or an algorithm to assess it.

+ +

+ Readiness Criteria +

+ +

The criteria here are used to evaluate whether a technical specification development effort is +ready for the W3C Recommendation Track. No single factor is decisive, and this document avoids RFC 2119 "MUST" and "SHOULD" terminology, and should not be a taken +as a checklist of necessary or sufficient criteria. Nevertheless, some criteria are +noted as "strongly recommended", and, if not met, an explanation of why they don't apply in a particular situation would +facilitate the W3C decision. Different cases will involve different combinations of these factors. In determining whether to +approve moving work to the Recommendation track, the Team may consider +other factors not listed in this document as well.

+ +

Assessing whether proposed work is likely to fulfull the W3C mission to lead the web to its full potential +is the traditional criterion the Team and Advisory Committee use to evaluate whether to start a working group or advance +a specification. While this is "aspirational", it requires +judgment that balances the future potential of the Web alongside the need for real developers to make the Web work in practice. +This document seeks to make the factors that go into this judgment +more explicit and generally applicable.

+ +

The "empirical" criteria are inspired largely by the experience of some open source browser projects +that use an intent to implement process +to build the case for shipping +a new feature. This document refines this approach to apply to Recommendation +Track transition decisions. +The Web Platform Incubator Community Group has adopted +something similar to determine when a spec under incubation is ready to propose to a +Working Group.

+ +

Is there a clear problem statement?

+ +

Strongly Recommended: The proposal identifies the real-world problem this work would address, and why existing solutions are inadequate.
+What are web developers forced to do without this feature being available in a standardized way? +What fraction of web sites, hybrid applications, data publishers, etc. are using a similar capability in a non-standardized way? +How would users benefit from this feature if standardized?

+ +

Are success criteria explicit?

+ +

Strongly Recommended: The proposal enumerates the types of products (browsers, servers, frameworks, applications...) would need to +support the spec for it to be +successful, and indicate what degree of critical mass would be needed.
+Is this spec serving a specialized community and only that community needs to implement and adopt it for it to be successful? +Or are there critical ecosystem dependencies, e.g. the spec must be deployed on both +the cloud/server and browser/client, +or must be supported both in products for producers and consumers of web content, to be really useful?

+ +

Is there a well-socialized proposal to address the problem?

+ +

Strongly Recommended: An initial draft of the technical specification has been written down and socialized in a community where potential users, web site / app +developer, framework/took developer, and core technology implementers are represented. +The state of community consensus around the initial draft should be documented: Did potential users and key implementers actively participate +in the discussion? Are there any indications that social or economic pressure was applied to suppress dissent? Did the discussion generate sustained expressions of opposition or unwillingness to implement / use / make patent +commitments from key stakeholders? If there are indications that consensus in a WG will be difficult to achieve, proposers are well advised +to make a persuasive case for how the proposed Recommendation Track work can be successful.

+ +

Has the proposed spec been incubated to reasonable maturity?

+ +

Strongly Recommended: Charters do not list specs as deliverables, and WGs do not publish FWPDs, until there is +rough consensus across stakeholders that the spec solves a real problem, is likely to be implemented, and is likely to +be used on the Web. This consensus could emerge from an incubation phase in WICG or another CG, or in a WG that has an established +culture of taking and vetting suggestions from its public mailing list.

+ +

The language in the +Web Platform WG charter describes a one community's practice:

+ +
+

The Working Group will not adopt new proposals until they have matured through the Web Platform Incubator Community +Group or another similar incubation phase.

+
+ +

If work is incubated in a CG, it is important to assess the degree of consensus behind a spec as well as its maturity. +While CG's are not required to work by consensus, those proposing work for the Recommendation track should favor proposals that +did get strong and broad consensus during the incubation phase, and make W3C staff aware of points of contention, rival proposals, etc. An optional W3C Community Group Charter Template contains provisions designed to promote fairness in CGs. CGs are encouraged to consider using the template as a starting point.

+ +

The key word is "matured", and the key milestone is First Public Working Draft (FPWD). It may be inefficient to charter WGs that start with +a "blank sheet of paper" or multiple proposals with different use cases, but it hurts W3C's credibility to +publish a formal Technical Report that specifies a technology that does NOT meet clear user needs in a way that has a good chance to be implemented in products, tools, websites, +and web applications. However the incubation phase is done, and whichever of these criteria are applied before proposing standardization +or developing a charter,this document strongly recommends that only "mature" specs be published as FPWDs.

+ +

Is it clear the proposers are not seeking a rubber stamp from W3C?

+ +

Strongly Recommended: Proposers of Recommendation-track work should be prepared for the Working Group to +make substantive changes to the initial draft in response to feedback. A W3C Recommendation signifies that a specification has broad consensus across the membership of W3C. It is particularly important to ensure that a spec both serves a real mainstream need +and is inclusive of a diverse, worldwide community using different languages, with various levels of ability, and +who interact with various levels of trust. Likewise, proposed Recommendation-track work should not promote + +

Are there appropriate expressions of interest?

+ +

The proposal points to statements of support from key stakeholders about the value proposition for the feature +it describes. Is there strong demand from potential users? Is there a critical mass of implementers tentatively interested in shipping this feature +if standardized? Are there prototype / polyfill implementations that are used in experimental apps / sites +that the target audience already finds useful?

+ +

Is there actual evidence to back up the answers?

+ +

The proposal describes what implementation and user experience is there to back up the points above. +What fraction of websites are implementing a similar feature in a non-standardized way? +How many users would potentially benefit from this feature if standardized? +Hard data is preferred, but estimates backed up by detailed explanations are acceptable.

+ +

Risks?

+ +

The proposal considers whether standardizing the spec could create more problems than it solves. +What are the potential downsides of having this feature standardized ...could it undermine security, privacy, accessibility, etc. +if broadly deployed? Are there scenarios under which we would regret standardizing this feature?

+ +

Is the timing right?

+ +

The optimal timing for a transition to the Recommendation Track can be described as:

+ + + +

If the answer “the ship has sailed”, proposers should explain how they propose to mitigate the situation without turning back the clock, +and what a Recommendation Track document could do to improve the situation. For example, clearly documenting what already interoperates, +and getting broader patent commitments on the interoperable behavior arguably has value.

+ +

Clear RF licensing commitments?

+ +

W3C seeks to issue Recommendations that can be implemented and used on a +Royalty-Free basis.

+
    +
  1. Are the technologies in the initial available under terms that are compatible with the +W3C Royalty-Free licensing requirements?
  2. +
  3. Have those who seem most likely to have relevant patents made commitments to license them on +royalty-free terms?
  4. +
  5. Is the provenance of substantive contributions to the draft reasonably clear?
  6. +
+ +

Team Engagement?

+ +

It is advisable for groups considering Recommendation Track work to consult with the W3C +Team early enough in the process for them to advise about potential problems and workarounds, and help draft a formal proposal.

+ +

Working Groups and Interest Groups have Team Contacts they can use for this purpose. Community Groups generally do not (see Team support for CGs), but CG participants are encouraged to reach out to the W3C staff well in advance of proposing a transition to the Recommendation Track.

+ + +

+ Process Considerations +

+ +

Discussion about these guidelines has generated a number of questions about how they relate to the W3C process and the Team's existing practices.
+They are out of scope for this document, but they are listed for reference:

+ +

Granularity

+ +

Should the considerations above be applied at at the specification level or the feature level?

+ +

Charter Scopes and Deliverables

+ +

When chartering a new WG, is it appropriate to put in scope a number of features that are mostly "aspirational" and put in the deliverables +section only those that meet most of the criteria above?

+ +

When an incubator spec is ready to move to a WG, does it wait (possibly a couple of years) +to get into a WG Charter or are is the expectation that WGs would re-charter to take on incubated spec proposals?

+ +

Or is the best practice to make the scope of charters broad enough to encompass work that may be incubated during +the charter's lifetime, and the WG would only take up an actual deliverable once it is incubated?

+ +

Community Groups and the W3C Process

+ +

How can we ensure that concerns raised at the TPAC 2015 AC meeting and the AC Forum thread on Mandatory Incubation are addressed +in the process or practice of W3C?

+ +

Should the Process Document describe a role for CGs in getting specifications ready to be standardized? Should the Community +and Business Group Process say more about the importance of working by consensus, at least for specifications that +are to be proposed for the Recommendation Track?

+ +

What to do when there is interest from users but not implementers?

+ +

Raised in the AC discussions.
+Should the Process Document do more to describe a role for Interest Groups in developing use cases for new Recommendations, +and perhaps working in tandem with one or more Community Groups to develop credible technical proposals to address those +use cases?

+ +

+ Conclusion +

+ +

The criteria above suggest that Recommendation Track work begin when there are satisfactory answers to 3 basic questions:

+ + + +
+
+
Coralie Mercier for the W3C Team - Feedback and comments are welcome. Please use Github issues. +
+ + diff --git a/standards-track/stages.md b/standards-track/stages.md new file mode 100644 index 0000000..88bf826 --- /dev/null +++ b/standards-track/stages.md @@ -0,0 +1,95 @@ +# Maintenance and Incubation + +## Status + +This is a proposal intended to facilitate maintenance of W3C Recommendations at W3C. + +## Problem Statement + +The W3C Technical Reports page contain a long list of W3C Recommendations that are not maintained properly, due to lack of editors, participants, or Working Groups. + +## Classes of Changes + +[W3C Process](https://www.w3.org/policies/process/#correction-classes) contains the following classes of changes: + +1. No changes to text content +2. Corrections that do not affect conformance +3. Corrections that do not add new features +4. New features + +We will refer to these classes in the different types of modifications below. + +## 7 Types of modifications + +We identify here 7 different types of modifications applicable to a W3C specification and the existing and recommended path to address them. + +All types of modifications, except for in-place modifications, will result in a new dated version of the W3C Recommendation. + +### 0. In-place modification of W3C Technical Reports + +There is a policy regarding the [in-place modification](https://www.w3.org/2003/01/republishing/) of W3C Recommendations. It allows the following types of modifications: + +1. Fixes to broken markup (e.g., invalid markup) (category 1) +2. Fixed to broken links (i.e., URIs) +3. Fixes to broken style sheets +4. Some visible status updates, such as indicating newer versions +5. An [individual's name upon request to a W3C Ombudsperson](https://www.w3.org/2016/02/trans-rec-edit.html) + +Except for those changes required by this [policy in section four](https://www.w3.org/2003/01/republishing/), no in-place changes to the text of a document, besides some visible status updates, are permitted, however minor. + +All those types of modifications are classified under the [Class of Change 1 and 2](https://www.w3.org/policies/process/#correction-classes), per W3C Process. + +Since the modifications are in-place, this will not result in a new dated version of a W3C Recommendation. + + +### 1. Editorial modifications + +Those modifications are classified under the [Class of Change 1 and 2](https://www.w3.org/policies/process/#correction-classes), per W3C Process and cannot be done as an in-place modification. + +Editorial changes to a Recommendation require no technical review of the proposed changes and do not need to be part of an errata page initially. This will result in an Edited Recommendation, at the request of a W3C Working Group or done directly by W3C. + +### 2. Maintenance of an errata page for the W3C Recommendation + +Each W3C Recommendation contains a link to an errata page. This page is best maintained by the corresponding Working Group. If no such Working Group exists, the W3C is responsible for maintaining the errata page and may need assistance in doing so, such as requesting the help of a Community Group. + +All those types of errata are classified under the [Class of Change 1, 2, and 3](https://www.w3.org/policies/process/#correction-classes), per W3C Process. + +This will not result in an Edited Recommendation. + +Note: this diverges from W3C Process, where only Working Groups are allowed to decide how to document errata. + +### 3. Revising a Recommendation using an errata list + +A list of errata becomes part of a W3C Recommendation by the process for revising a Recommendation. To make corrections to a W3C Recommendation, a Working Group may request publication of a Candidate Recommendation. If no such Working Group exists, the W3C is responsible for requesting the publication of a Candidate Recommendation. If this is done at the request of W3C instead of a Working Group, the status should indicate that the substantive changes are NOT covered by the W3C Patent Policy. This is an acceptable trade-off between having a broken Recommendation with full patent policy coverage and a well-maintained Recommendation without RF commitments. However, the [disclosure requirement](https://www.w3.org/policies/patent-policy/#sec-disclosure-requirements) still applies. + +All those types of errata are classified under the [Class of Change 1, 2, and 3](https://www.w3.org/policies/process/#correction-classes), per W3C Process. + +This will result in an Edited Recommendation, at the request of a W3C Working Group or done directly by W3C. + +Note: this diverges from W3C Process, where only Working Groups are allowed to request substantive corrections to a W3C Recommendation. + +### 4. New features that were previously classified "at risk" + +Working Groups may identify features in a document as "at risk". These features may be removed before advancement to Proposed Recommendation without a requirement to publish a new Candidate Recommendation, per [W3C Process](https://www.w3.org/policies/process/#candidate-rec). + +Such feature should stay within the scope of the Working Group and may be reincorporated in a future version of the W3C Recommendation. + +These features are classified under the [Class of Change 4](https://www.w3.org/policies/process/#correction-classes), per W3C Process. + +This will result in a new Recommendation, at the request of a W3C Working Group. + +### 5. New features under discussion but not included + +Working Groups may identify new features while working on a document but not have enough time to include them as part of the specification. + +Such discussion/feature should stay within the scope of the Working Group and may be incorporated in a future version of the W3C Recommendation. + +These features are classified under the [Class of Change 4](https://www.w3.org/policies/process/#correction-classes), per W3C Process. + +This will result in a new Recommendation, at the request of a W3C Working Group. + +@@need example + +6. Brand new feature + +Those features were not listed or discussed sufficiently while working on the specification. As such, those should be incubated in a Community Group first.