Skip to content

Latest commit

 

History

History
203 lines (144 loc) · 12.8 KB

workmode.md

File metadata and controls

203 lines (144 loc) · 12.8 KB

Preface

Please read this proposal carefully.

  • It may contain elements that strongly resemble proposals made and rejected years ago. Times have changed. I ask everybody to evaluate this proposal anew, and not dwell on the past.

  • It may contain elements that strongly resemble proposals made within the past few weeks. It may also be missing crucial elements from those proposals. I ask that everybody evaluate this proposal as a standalone proposal.

Key elements of the proposal described below:

As an alternative to doing this work inside the WebApps WG, a new Working Group could be chartered. A draft charter is available for discussion. If such a charter were adopted, this workmode would need to be updated to change the name of the sponsoring Working Group.

This working group could even be a joint WG with the IETF.

For reference purposes only, here are some related links:

WorkMode

The W3C Web Applications Working Group has a published WorkMode. This is the WorkMode for the URL work during the 2015-2016 calendar years. Extensions, early termination, and adoption of some or all of this by other efforts are all possible, but outside of the scope of this document.

Participation and Communication

The primary place for work on the URL standard has been, and continues to be:

All technical communications are to take place on a publicly archived list. As an example, this includes www-archive. In general, the editors intend to aggressively follow up with any individual or group that has technical input and will bring the results of those efforts back to the venues mentioned above. The current list of alternate venues being evaluated:

The Technical Reports Process (What is an Editor's Draft?)

The URL Living Standard is effectively an Public Working Draft and matches the description of an Editor's draft as practiced by the WebApps WG.

There have been discussions concerning having a W3C Working Group such as WebApps "sponsor" this effort; the proposal is that the WG would do so according to the workmode as described by this page. A decision to adopt this workmode be an entirely voluntary one by the WebApps working group.

This would primarily involve the Working Group producing Transition Requests. As a part of doing so, stable snapshots would be made.

The first such snapshot is available at http://www.w3.org/TR/2014/WD-url-1-20141209/. This snapshot is hosted by the W3C, using standard W3C stylesheets and logo. It is licensed under the terms required by the WebApps charter. It includes a status section. It refers to the WHATWG URL Standard as the editor's draft. The Acknowledgments section lists the editors, refers to the WHATWG standard as the upstream draft, and mentions the license under which the WHATWG standard is made available.

There are no technical content differences. The content is pulled from the master branch of the whatwg GitHub repository into the develop branch of the w3ctag GitHub repository. The complete list of changes is available online.

Later in the process, the proposal is to adopt the Public Permissive version 3 exit criteria in order to satisfy the need for demonstrating Implementation Experience. Any changes needed to the specification to meet this exit criteria will be done in the whatwg GitHub repository, if necessary in a branch.

Also later in the process there may be possible differences in the normative references, primarily to meet the W3C Normative References Policy. Those changes, if any, will be done in the w3ctag GitHub repository.

The WebApps Working Group would also need to record and present Formal Objections. It is conceivable that the resolution of such a Formal Objection could result in a fork. The process by which such a potential fork would be managed is outside of the scope of this document.

By the end of 1Q 2015, there will be a meeting with the W3C Director to review all of this and determine if the WHATWG URL Living Standard can be referenced directly instead. The need for each of the changes listed above (logo, license, status, references, acknowledgements) will be explored and challenged.

Editors

In the W3C, editors are appointed by WG chairs. In the WHATWG editors agree to add other editors. Ideally, the way to make this work is for the W3C chairs of the WebApps working group voluntarily agree to limit their activities to confirming changes to editors, and for us to not spend time working out the implications of what would happen if such a change were not confirmed.

There is no predefined criteria for becoming an editor. The most common way for this to occur is after a sustained period of producing quality pull requests.

Bugs, Issues and Actions

Bugzilla and github issues are used by the URL Standard.

The WebApps working group may chose to track actions items.

Patent Policy

This is general agreement on Royalty Free Licensing and Disclosure requirements. In practice, agreeing to join the relevant Working Group is a part of collecting the necessary commitments. Unfortunately, there is a pervasive perception that the necessary agreements to do so impose requirements inconsistent with the working mode described on this page. Specifically:

An alternate approach that has been tried in the past is to use the CG process to obtain licensing commitments.

Also worth noting, the acknowledgements section contains a list of people who have already contributed.

For URL to become a W3C Recommendation, the W3C will need to define a workable process that gets the necessary commitments without imposing unrelated requirements. The proposal is therefore to:

  • Get the W3C to publicly state that this WorkMode is consistent with the W3C Process, and therefore nothing in Section 7 of Appendix 1 of the Member agreement would inhibit this WorkMode being adopted.
  • Modify section 2.2 of the Invited Expert agreement to align it with the Member Agreement. See also issue 150 in the w3process CG.

Meetings

No telecons have been held or are expected.

Discussions on #whatwg IRC channel are commonplace.

URL has been a topic of discussion at F2F meetings such as TPAC. As is the custom with WebApps, any results are to be taken back to public mailing lists.

Consensus and Call for Consensus

The only Calls for Consensus by the WebApps working group relating to URL will be for process related items: decisions to "sponsor" this work, decisions related to exit criteria and transition requests, and decisions to host a fork of this product. Going into this agreement, everybody agrees that such a fork is a measure of last resort.

Mail List Policy

Discussions that are held in various venues will conform to the norms expected of those venues. No additional URL specific mailing list policies are being proposed or are expected.

Off-Topic Discussion Policy

Again, discussions that are held in various venues will conform to the norms expected of those venues. As those venues generally are not limited in scope to the URL standard, messages on such lists may be unrelated to the URL standard.

IRC

Discussions related to the URL standard occur on #whatwg IRC channel.

Testing

Tests can be found in the url/ directory of w3c/web-platform-tests.

Version Control

whatwg/url and webspecs/url repositories on GitHub are currently being actively used. Neither consistently are "upstream" from each other, and the plans are to actively keep them in sync.

The develop branch of the w3ctag GitHub repository will contain the content from which drafts published on the W3C TR page are produced.

Links to Group Resources

A list of resources is available on discourse.specifiction.org.