Difference between revisions of "WorkMode"
m (→Meetings? What Meetings?)
(Added new Section for a Off Topic Discussion Policy)
|Line 121:||Line 121:|
** Follow [http://www.w3.org/TR/WAI-WEBCONTENT/ Web Content Accessibility Guidelines] (WCAG)
** Follow [http://www.w3.org/TR/WAI-WEBCONTENT/ Web Content Accessibility Guidelines] (WCAG)
== IRC ==
== IRC ==
Revision as of 14:42, 6 December 2012
The purpose of this wiki is to consolidate some of the Web Applications WG's (aka WebApps) Real Working Modes including: Participation and Communication, Meetings, Consensus, Mail List usage, links to important resources, etc.
Note the WG's Charter formally defines many aspects of the group's working mode. In all cases, the Charter and/or the W3C Process Document overrides the information in this wiki. Nevertheless, this wiki contains additional information about how the group really works and as such, this information may be particularly useful to new members of the WG.
This document is a Living Document and as such will change. Members of the WG are encouraged to edit (e.g. to embellish, correct, etc.) the information in this document.
- 1 Participation and Communication
- 2 The Technical Reports Process (What is an Editor's Draft?)
- 3 Editors
- 4 Bugs, Issues and Actions
- 5 Patent Policy
- 6 Meetings? What Meetings?
- 7 Consensus and Call for Consensus
- 8 Mail List Policy, Usage, Etiquette, etc.
- 9 Off Topic Discussion Policy
- 10 IRC
- 11 Testing
- 12 CVS and Mercurial
- 13 Links to Group Resources
Participation and Communication
Strictly speaking, only the Chairs and Editors have firm participation requirements. However, all WG members are strongly encouraged to participate in all of the specifications in progress.
A WG member may participate in various ways including:
- Attending one of the group's formal meetings
- Participating in discussions on the WG's mail lists (see below)
- Being an Editor of one or more of the group's active specifications
- Participate in discussions on the group's #webapps IRC channel
Participation from the Public, via our Public mail lists is also welcome, provided comments, contributions, etc. are consistent with the W3C Patent Policy. The group uses the following mail lists:
- public-webapps; for all technical discussions except for the other mail lists in this list
- public-webapps-testsuite; testing related discussions
- www-dom; for discussions about the group's DOM specs
- public-script-coord; for discussions about the Web IDL spec and ECMA TC39 coordination
- public-web-intents; used by the Web Intents Task force between WebApps and the Device API WG
The Technical Reports Process (What is an Editor's Draft?)
This group uses Editor's Drafts (ED) which, as the name indicates, is simply the latest version of a specification an Editor maintains. An ED should be thought of as the tip of the tree i.e. a work in progress that may change at any point in time.
EDs are not formal publications by the W3C and as such, the W3C Process Document does not explicitly define them.
Those with a vested interest in a specification e.g. implementers and application developers, should use a spec's Editor's Draft and not a dated version of the ED that was published as a Working Draft in the W3C's Technical Reports repository.
The W3C Process Document defines a so-called Publication "Heart Beat" Requirement that states a WG should publish each spec in the Technical Reports (aka /TR/) repository. For various reasons, including the relatively large number of specs in development, this WG does not generally follow this requirement.
Editors in this Working Group have wide freedom to update (add, change, delete) text in Editor's Drafts without explicit consensus from the group. This method is referred to as Edit First and Review Later and is contrary to other WGs that follow a Review First and Edit Later editing model.
Does this does mean WG members' input is not taken into account? No. Editors are expected to consider all inputs and to reflect that input in the ED.
Note: before the WG formally publishes a specification as a Technical Report (i.e. a copy of the spec is placed in the Technical Reports repository), WG members will be asked if there is consensus to publish the specification (as described in this document's Call for Consensus section).
WebApps' SpecEditing wiki includes information about spec editing, including Editor roles and responsibilities.
Bugs, Issues and Actions
The WG has no single mechanism to record and track issues. Some spec Editors record issues directly in the spec (e.g. "Issue: ..."), a few spec Editors still use the WebApps' Tracker Tool to track issues but most spec Editors use W3C's Bugzilla.
Bugzilla is the preferred bug tracking mechanism for all new specs. See WebApps' Bugzilla components for a list of the specs (components) using Bugzilla.
(Tracker does have a nice feature that it scans all of WebApps' mail lists for the patterns "ISSUE-NNN" and "ACTION-NNN" (where NNN is an issue or action number). If that pattern is found, the URI of the e-mail in the public-webapps archive will automatically be included in the database record for that issue or action.)
The WG's Charter defines the Patent Policy for this group:
- This Working Group operates under the W3C Patent Policy (5 February 2004 Version). To promote the widest adoption of Web standards, W3C seeks to issue Recommendations that can be implemented, according to this policy, on a Royalty-Free basis.
For more information about disclosure obligations for this group, please see the W3C Patent Policy Implementation.
A consequence of the group's Patent Policy is that inputs for the group's specifications from non-WG participants is not permitted. See the W3C Patent Policy FAQ titled How should Working Groups handle contributions from non-participants (e.g., meeting guests or on public lists)? for more information about contributions from non-WG participants.
Meetings? What Meetings?
Most of WebApps' specification work progresses without formal meetings. Instead, all of the technical work is done via the group's various mail lists, IRC and Bug databases.
The consortium usually has an annual All Working Group f2f meeting week and this group normally has a f2f meeting during that week.
See WebApps' Meeting Wiki for information about the group's formal meetings.
Consensus and Call for Consensus
Consensus is a very important part of the W3C process and is formally codified in the Process Document as follows:
- Consensus is a core value of the W3C. To promote consensus, the W3C process requires Chairs to ensure that groups consider all legitimate views and objections, and endeavor to resolve them, whether these views and objections are expressed by the active participants of the group or by others (e.g., another W3C group, a group in another organization, or the general public).
Since much of WebApps' work is done without formal meetings, the group uses a Call for Consensus (aka CfC) mechanism (typically email) to formally gather input on a specific question such as Is spec X ready to publish as a Last Call Working Draft?. When a CfC is issued, an explicit response from WG members is preferred and note that the lack of a response will always be considered assent i.e. agreement with the proposal.
Most CfC's are done on the public-webapps mail list and the comment period is typically one week. However, in some rare cases, for example when Member confidentially is an issue, the member-webapps mail list is used.
Note the CfC mechanism may not be used with some of the WG's work, for instance, those WG members working on the Widgets specs do not typically use CfCs because they have regularly scheduled meetings.
Mail List Policy, Usage, Etiquette, etc.
The Consortium has formal Mail List policies and procedures yet also accommodates some flexibility on how mail lists are used:
- Each W3C mailing list has its own policies regarding who may post to the list. Those subscribed to each list are generally able to post directly to the list without delay; those who are not may be subject to manual moderation (at least the first time they post.)
WebApps' members appreciate and encourage frank technical discussions on our mail lists but all discussions must be done in a respectful manner. Please note this respect requirement is codified in the Process Document via the following participation criteria "Social competence in one's role". Additionally, see Positive Work Environment Task Force and if you did not attend Kindergarten, we expect our list participants to adhere to the basic principles in All I Really Need To Know I Learned In Kindergarten.
We also expect our mail list participants to adhere to the following:
- Follow basic Netiquette such as avoiding typing in ALL CAPS
- Messages should be encoded using plain text
- Messages should not use top-posting. See the WHATWG's top-posting guidelines for more information and this email from Tobie Langel for information about top-posting and Outlook and Outlook Express.
- Subjects should be prefaced with the name of the spec (for example: [DOM4] Blah, Blah, Blah)
- Attachments must follow the W3C Guidelines for Email Attachment Formats, in particular:
- Avoid unnecessary email attachments.
- Use an attachment only when it is likely to benefit to recipients. Otherwise, place the information (in plain text format) in the body of your message.
- If an attachment is necessary, avoid formats that are virus prone, proprietary or platform dependent. For example, whenever possible you should use HTML instead of MS Word, PowerPoint or PDF.
- Follow Web Content Accessibility Guidelines (WCAG)
Off Topic Discussion Policy
Webapps' mail lists are only to be used for technical discussions of the group's specifications. Discussions related to general W3C wide processes and policies are not appropriate for any of WebApps' mail lists and as such, discussions on those subjects are considered "off topic".
Here is a list of documents and topics that are explicitly off topic for WebApps' mail lists, including one or more appropriate discussion forums that may be used:
- W3C Process Document - the Revising W3C Process Community Group; the W3C Advisory Board; the W3C Advisory Committee
- W3C Patent Policy - the Revising W3C Process Community Group; the Patent and Standards Interest Group
We expect everyone using WebApps' mail lists to please respect this policy.
WebApps uses two different channels of the W3C's IRC system (irc.w3.org; port 6667):
- #webapps - for Public technical discussions; this channel is continuously logged/archive
- #wam - for Member-confidential discussions; this channel is NOT logged
The WG's charter mandates the WG create a comprehensive test suite for all features of a specification is necessary to ensure the specification's robustness, consistency, and implementability, and to promote interoperability between User Agents.
The WG's main testing resources are:
- Testing - wiki that describes the group's testing work
- http://w3c-test.org/webapps/ - HTTP root of the group's Mercurial-based testing repository
- public-webapps-testsuite - archive of the group's testing mail list
- Test Facilitators - each spec's Test Facilitator is identified in the Testing column of the group's PubStatus document
CVS and Mercurial
The WG uses CVS and in the spring of 2010 started using Mercurial. Mercurial should now be used for all new specs.
Some Mercurial links:
- W3C's Mercurial Root: http://dvcs.w3.org/hg
- WebApps' Root: http://dvcs.w3.org/hg/webapps/ and Mirror for easier browsing
- See: Mercurial Information - a Quick User's Guide and download information; short Mercurial Blog by Anne van Kesteren
The group uses several different CVS directories for the group's old-ish specs:
- HTML5 APIs: http://dev.w3.org/cvsweb/html5/ (e.g. WebWorkers, WebSockets, WebMessaging, WebStorage, Server-sent Events)
- "Web APIs": http://dev.w3.org/cvsweb/2006/webapi/ (e.g. Selectors v1/v2, Cliboard API, Web IDL, File API)
- Widget specs: http://dev.w3.org/cvsweb/2006/waf/
- File API specs: http://dev.w3.org/cvsweb/2009/dap/; 2 of WebApps' File specs (File API: Writer and File API: Directories and System) are in the DAP WG's CVS repository
See the following documents for more information about CVS and its usage in the W3C:
Links to Group Resources
- Public wiki: http://www.w3.org/2008/webapps/wiki/Main_Page
- Charter: http://www.w3.org/2012/webapps/charter/
- Publication status http://www.w3.org/2008/webapps/wiki/PubStatus
- WG participants list: http://www.w3.org/2000/09/dbwg/details?group=42538
- Public mail list archives (see purpose and usage info above):
- Member-Confidential mail list archive: http://lists.w3.org/Archives/Member/member-webapps/
- Actions, Issues and Bugs ...
- W3C's Bugzilla Database: <http://www.w3.org/Bugs/Public/describecomponents.cgi?product=WebAppsWG>; used by most specs
- Action and Issues database: http://www.w3.org/2008/webapps/track/; still used by a few specs but the expectation is that all specs will eventually use Bugzilla
- Telcon/Voice Conference info: http://www.w3.org/2008/webapps/wiki/Telcons
- WebApps Coordination Points; identifies W3C WGs and external organizations with mutual areas of interest