From 995c6b35f998d955711639ad562152096f799dc2 Mon Sep 17 00:00:00 2001 From: Vivien Lacourba Date: Fri, 10 Jan 2025 15:44:53 +0100 Subject: [PATCH] Fix heading levels and links --- index.md | 214 +++++++++++++++++++++++++------------------------------ 1 file changed, 97 insertions(+), 117 deletions(-) diff --git a/index.md b/index.md index fe5290da7..879aae810 100644 --- a/index.md +++ b/index.md @@ -3,217 +3,197 @@ title: The Art of Consensus toc: true --- - - -### Starting a Group {#start} - -- [Recommendation Track Readiness Best - Practices](https://www.w3.org/Guide/standards-track/) +## Starting a Group {#start} + +- [Recommendation Track Readiness Best Practices](standards-track/) {:#Recommendation} -- [Create a Charter](process/charter.html) +- [Create a Charter](process/charter.md) {:#Charters} -- [How to incubate](https://www.w3.org/Guide/incubation.html) +- [How to incubate](incubation.md) - - [W3C Community & Business Groups](https://www.w3.org/community/) + - [W3C Community & Business Groups](https://www.w3.org/community/) - [W3C Team support for W3C Community Groups](https://www.w3.org/2016/04/cg-support/) - - [W3C Workshops](https://www.w3.org/Guide/meetings/workshops.html)for starting incubation -- [How to transition work from a Community Group to a Working Group](process/cg-transition.html) -- [Join a group](https://www.w3.org/participate/faq.html#join)(see also [Invited Expert Policy](https://www.w3.org/2004/08/invexp.html)) + - [W3C Workshops](meetings/workshops.md) for starting incubation +- [How to transition work from a Community Group to a Working Group](process/cg-transition.md) +- [Join a group](https://www.w3.org/get-involved/) (see also [Invited Expert Policy](https://www.w3.org/invited-experts/)) - If you need a blog, wiki, GitHub repository, or mailing list, ask your team contact. - ...more [advice on roles in a group](#roles) -### Running a Group {#run} +## Running a Group {#run} -- [W3C Chair Buddy System](https://www.w3.org/Guide/chair/buddy.html)(volunteer experienced Chairs can mentor other Chairs) -- Check out our [Working Groups](https://www.w3.org/PM/Groups/chairboards.html?gtype=working)and [Interest Groups](https://www.w3.org/PM/Groups/chairboards.html?gtype=interest)dashboards to navigate through what we know about them. The Project Management team only maintains a [collection of links and tools](https://www.w3.org/PM/)to keep track. +- [W3C Chair Buddy System](chair/buddy.md) (volunteer experienced Chairs can mentor other Chairs) +- Check out our [Working Groups](https://www.w3.org/PM/Groups/chairboards.html?gtype=working) and [Interest Groups](https://www.w3.org/PM/Groups/chairboards.html?gtype=interest) dashboards to navigate through what we know about them. The Project Management team only maintains a [collection of links and tools](https://www.w3.org/PM/) to keep track. - [Moderating (Facilitating) Meetings](https://www.w3.org/wiki/Moderating_Meetings) - [Creating and delivering effective presentations](https://www.w3.org/wiki/Speaker_Resources) -- Running a Meeting (especially a teleconference) on [IRC](https://www.w3.org/Project/IRC/)( [Web client](https://irc.w3.org/)): +- Running a Meeting (especially a teleconference) on [IRC](https://www.w3.org/Project/IRC/) ([Web IRC client](https://webirc.w3.org/)): - - See [how to setup a new group](tools/new-group.html)for general tooling advises - - [Quick start guide](https://w3c.github.io/scribe2/scribedoc.html)on setting up tools for managing an agenda, generating minutes, and updating issues lists - - [Scheduling teleconferences](https://www.w3.org/Guide/meetings/zoom) - - [Group calendars](https://www.w3.org/Guide/meetings/organize.html#calendars) - - [Holidays wiki](https://www.w3.org/wiki/Holidays)to help planning WG work around recurring holidays + - See [how to setup a new group](tools/new-group.md) for general tooling advises + - [Quick start guide](https://w3c.github.io/scribe2/scribedoc.html) on setting up tools for managing an agenda, generating minutes, and updating issues lists + - [Scheduling teleconferences](meetings/zoom.md) + - [Group calendars](meetings/organize.md#calendars) + - [Holidays wiki](https://www.w3.org/wiki/Holidays) to help planning WG work around recurring holidays - Individual IRC tools ("bots"): - - [Zakim](https://www.w3.org/2001/12/zakim-irc-bot.html)for queue management, start and end meeting - - [RRSAgent](https://www.w3.org/2002/03/RRSAgent)for minutes management + - [Zakim](https://www.w3.org/2001/12/zakim-irc-bot.html) for queue management, start and end meeting + - [RRSAgent](https://www.w3.org/2002/03/RRSAgent) for minutes management - Hints for [rescuing minutes when RRSAgent is absent](https://w3c.github.io/scribe2/rescue.html) -- [Predicting milestones](process/predicting-milestones.html), use our [milestones calculator](https://w3c.github.io/spec-releases/milestones/)to help with dates. +- [Predicting milestones](process/predicting-milestones.md), use our [milestones calculator](https://w3c.github.io/spec-releases/milestones/) to help with dates. - Face-to-face meetings - - [**Continuity of Operations under Travel Restrictions**](meetings/continuity) - - [Host a face-to-face meeting](meetings/hosting.html)and [Standard Venue Arrangements for W3C Events: Conferences, Workshops, and Meetings](https://www.w3.org/2011/06/WorkshopHost.html) - - [Policy Regarding Non-Disclosure Agreements and W3C Meetings](https://www.w3.org/2004/06/NoNDAPolicy.html) + - [**Continuity of Operations under Travel Restrictions**](meetings/continuity.md) + - [Host a face-to-face meeting](meetings/hosting.html) and [Standard Venue Arrangements for W3C Events: Conferences, Workshops, and Meetings](https://www.w3.org/2011/06/WorkshopHost.html) + - [Policy Regarding Non-Disclosure Agreements and W3C Meetings](https://www.w3.org/policies/no-nda/) - [W3C Travel Policy affecting Staff Contacts](https://lists.w3.org/Archives/Member/chairs/2017JanMar/0141.html) - Issue tracking: - - Use [GitHub](https://github.com/w3c/)to track issues through mail and the Web -- [WBS](https://www.w3.org/2002/09/wbs/)for questionnaires + - Use [GitHub](https://github.com/w3c/) to track issues through mail and the Web +- [WBS](https://www.w3.org/2002/09/wbs/) for questionnaires - People management - - [HumanDimension](https://www.w3.org/wiki/Guide/HumanDimension)(a Chair training module) - - [Code of Conduct](/policies/code-of-conduct/)and [Procedures](/about/positive-work-environment/#Procedures)to assist all parties when issues arise. We have [guidelines to suspend or remove participants from groups](process/suspension.html). See more on the [Positive Work Environment Home Page](https://www.w3.org/Consortium/pwe) -- [Antitrust and competition policy](/policies/antitrust/) -- [Copyrights for documents, software, tests](/copyright/) + - [HumanDimension](https://www.w3.org/wiki/Guide/HumanDimension) (a Chair training module) + - [Code of Conduct](https://www.w3.org/policies/code-of-conduct/) and [Procedures](https://www.w3.org/about/positive-work-environment/#Procedures) to assist all parties when issues arise. We have [guidelines to suspend or remove participants from groups](process/suspension.md). See more on the [Positive Work Environment Home Page](https://www.w3.org/about/positive-work-environment/) +- [Antitrust and competition policy](https://www.w3.org/policies/antitrust/) +- [Copyrights for documents, software, tests](https://www.w3.org/copyright/) - ...more [advice on meetings, decisions, issue tracking](#mtg-advice) -### Closing a Group {#close} +## Closing a Group {#close} -- [How to Close a Working Group](./process/closing-wg) +- [How to Close a Working Group](process/closing-wg.md) -### Specification Development {#Deliverables} +## Specification Development {#Deliverables} -- [W3C Editors home page](editor/)and specifically the [Style for Group-internal Drafts](editor/editors-draft) +- [W3C Editors home page](editor/) and specifically the [Style for Group-internal Drafts](editor/editors-draft.md) - Advancement on the Recommendation Track: - [W3C Process for Busy People](https://github.com/w3c/wg-effectiveness/blob/master/process.md) - - [Section 6.3 Technical Reports](/policies/process/#rec-advance)of the W3C Process - - Considerations for [joint deliverables](process/joint-deliverables.html) - - [Transition requirements](https://www.w3.org/Guide/transitions/)for all W3C maturity levels (First Public Draft, Last Call, CR, PR, REC, etc.). Try also our [step finder](https://w3c.github.io/transitions/nextstep.html)and look at [milestones calculator](https://w3c.github.io/spec-releases/milestones/). - - [Request Wide Review](https://www.w3.org/Guide/documentreview/)at least *2-3 months before CR*, to allow time for discussion and rework. This includes requesting [horizontal reviews](https://www.w3.org/Guide/documentreview/#how_to_get_horizontal_review). - - [Pubrules](https://www.w3.org/pubrules/)( [publication requirements](https://www.w3.org/pubrules/doc)) and links to related policies (e.g., [namespaces](https://www.w3.org/2005/07/13-nsuri), [MIME type registration](https://www.w3.org/2020/01/registering-mediatypes), [version management](https://www.w3.org/2005/05/tr-versions), and [in-place modifications](https://www.w3.org/2003/01/republishing/)) + - [Section 6.3 Technical Reports](https://www.w3.org/policies/process/#rec-advance) of the W3C Process + - Considerations for [joint deliverables](process/joint-deliverables.md) + - [Transition requirements](transitions/) for all W3C maturity levels (First Public Draft, CR, PR, REC, etc.). Try also our [step finder](transitions/nextstep.html) and look at [milestones calculator](https://w3c.github.io/spec-releases/milestones/). + - [Request Wide Review](documentreview/) at least *2-3 months before CR*, to allow time for discussion and rework. This includes requesting [horizontal reviews](documentreview/#how-to-get-horizontal-review). + - [Pubrules](https://www.w3.org/pubrules/) ([publication requirements](https://www.w3.org/pubrules/doc)) and links to related policies (e.g., [namespaces](https://www.w3.org/2005/07/13-nsuri), [MIME type registration](https://www.w3.org/2020/01/registering-mediatypes), [version management](https://www.w3.org/2005/05/tr-versions), and [in-place modifications](https://www.w3.org/2003/01/republishing/)) See also [Pubrules issue management](https://github.com/w3c/specberus/issues) - **March 2017**: [Obsoleting and Rescinding W3C Specifications](https://www.w3.org/2016/11/obsoleting-rescinding/) -- [Normative References](process/tilt/normative-references.html); considerations the Team takes into account when evaluating normative references -- Addressing formal objections: [best practices to resolve and decide Formal Objections](./council/council)(aka council guide) -- Publications can only happen on Tuesdays and Thursdays ( [Member-only archive of announcement](https://lists.w3.org/Archives/Member/chairs/2009JanMar/0192.html)), unless you use the [automated publication system](https://github.com/w3c/echidna/wiki) +- [Normative References](process/tilt/normative-references.md); considerations the Team takes into account when evaluating normative references +- Addressing formal objections: [best practices to resolve and decide Formal Objections](council/council.md) (aka council guide) +- Publications can only happen on Tuesdays and Thursdays ([Member-only archive of announcement](https://lists.w3.org/Archives/Member/chairs/2009JanMar/0192.html)), unless you use the [automated publication system](https://github.com/w3c/echidna/wiki) - **September 2015**: W3C Comm Team no longer post Homepage News stories for regular WDs publications, unless explicitly requested at publication request. -- [W3C Documents and license related to API definitions, code samples, or examples](process/binding-license) +- [W3C Documents and license related to API definitions, code samples, or examples](process/binding-license.md) - Discussion about specifications tooling and versioning on [spec-prod@w3.org](https://lists.w3.org/Archives/Public/spec-prod/) - ...more [advice on specification development](#spec-advice) -### Speaking About Your Work {#speaking} +## Speaking About Your Work {#speaking} -- Blogs, articles, Press interviews: Working Group participants, TAG Members, W3C Staff are among the world's experts in Web technologies and their impacts. Give heads-up, share relevant work, things you author, or press enquiries, by writing to the W3C Comm team ( [w3t-pr@w3.org](mailto:w3t-pr@w3.org)) about how you may attribute your work (or not) to W3C. -- Use the [Upcoming Talks form](https://www.w3.org/blog/talks/how-to-add-a-new-talk/)(W3C Group participants, members of the W3C Team, and Office Staff); talks publicized on [W3C home page](https://www.w3.org/), [Public Weekly Newsletter](https://lists.w3.org/Archives/Public/w3c-announce/), W3C Social Media. +- Blogs, articles, Press interviews: Working Group participants, TAG Members, W3C Staff are among the world's experts in Web technologies and their impacts. Give heads-up, share relevant work, things you author, or press enquiries, by writing to the W3C Communications team <[w3t-pr@w3.org](mailto:w3t-pr@w3.org)> about how you may attribute your work (or not) to W3C. +- Write on the [W3C Blog](https://www.w3.org/news-events/about-w3c-blog/) (open to W3C Group participants, members of the W3C Team); talks publicized on [W3C home page](https://www.w3.org/), [Public Weekly Newsletter](https://lists.w3.org/Archives/Public/w3c-announce/), W3C Social Media. - [Press release testimonial guidelines](https://www.w3.org/2004/12/testimonial_pr-guidelines.html) - [Creating and delivering effective presentations](https://www.w3.org/wiki/Speaker_Resources) - [How to Make Presentations Accessible to All](https://www.w3.org/WAI/training/accessible) ## Reference {#ref} -*Tools in this section and the previous are in wide use and are supported by the systems team (ask for help on [sysreq@w3.org](mailto:sysreq@w3.org)) and comm team. For service enhancements or new systems projects, please contact [w3t-sys@w3.org](mailto:w3t-sys@w3.org)with a detailed description of your needs. Outages and scheduled operations appear on the [W3C System Status page](https://status.w3.org). See [collected wisdom](#sa34)below for less mature tools.* +*Tools in this section and the previous are in wide use and are supported by the Systems Team (ask for help on [sysreq@w3.org](mailto:sysreq@w3.org)) and Communications Team. For service enhancements or new systems projects, please contact [w3t-sys@w3.org](mailto:w3t-sys@w3.org) with a detailed description of your needs. Outages and scheduled operations appear on the [W3C Systems Status page](https://status.w3.org). See [collected wisdom](#sa34) below for less mature tools.* -#### Systems and Tools {#systems} +### Systems and Tools {#systems} - [Markup Validators](https://validator.w3.org/), [Link checker](https://validator.w3.org/checklink), [Spell checker](https://www.w3.org/2002/01/spellchecker), [HTML diff tool](https://services.w3.org/htmldiff), [SpecRef](https://www.specref.org/), [normative references checker](https://labs.w3.org/normative-references/), [bibliography generator](https://www.w3.org/2002/01/tr-automation/tr-biblio-ui), and [more tools](https://www.w3.org/2004/12/wg-tools.html) - See also: [Tools Wiki](https://www.w3.org/2006/tools/)and [W3C Editors home page](editor/) -- [Mailing list archive](https://lists.w3.org/Archives/Member/w3c-tools/)of tools announcements (Member-only) -- [Predefined ACLs](https://www.w3.org/2002/02/auto-acl) -- [Edit your contact information or affiliation](https://www.w3.org/users/myprofile) -- Start with [modern tooling](https://github.com/w3c/modern-tooling/issues)for ongoing tooling issues. +- [Mailing list archive](https://lists.w3.org/Archives/Member/w3c-tools/) of tools announcements (Member-only) +- [Edit your contact information or affiliation](https://www.w3.org/users/myprofile/) +- Start with [modern tooling](https://github.com/w3c/modern-tooling/issues) for ongoing tooling issues. -#### Mailing Lists {#mlistools} +### Mailing Lists {#mlistools} -- [Mailing List Audit](https://www.w3.org/Member/Mail/AuditForm)(who is subscribed, information about lists) (Member-only) -- [SmartList Remote Maintainers Guide](teamcontact/RemoteMaintainers.html) -- [Spam filtering options](https://www.w3.org/2002/11/spam-filtering) +- [Mailing Lists archives](https://lists.w3.org/Archives/Public/) - [Mailing Lists Search service](https://www.w3.org/Search/Mail/) +- [Your Mailing List subscriptions](https://lists.w3.org/admin/subscriptions) +- [SmartList Remote Maintainers Guide](teamcontact/remote-maintainers.md) +- [Spam filtering options](https://www.w3.org/2002/11/spam-filtering) -#### Guidelines and Policies {#policies} +### Guidelines and Policies {#policies} -- [Antitrust and Competition Guidance](/policies/antitrust/) -- [Charter Extensions](https://www.w3.org/2015/04/charter-extensions.html) -- [External Funding](https://www.w3.org/2017/05/external-funding.html) -- [Invited Experts policy](https://www.w3.org/participate/invited-experts/) -- [IPR policies](https://www.w3.org/policies/) -- [NDAs and W3C Meetings](https://www.w3.org/2004/06/NoNDAPolicy.html) -- [Normative References guidelines](process/tilt/normative-references.html) -- [Processing of Formal Objections](council/council) -- [Continuity of Operations under Travel Restrictions](https://www.w3.org/Guide/meetings/continuity.html) +- [Policies & legal information](https://www.w3.org/policies/) +- [Antitrust and Competition Guidance](https://www.w3.org/policies/antitrust/) +- [Charter Extensions](process/charter-extensions.md) +- [Invited Experts policy](https://www.w3.org/invited-experts/) +- [Normative References guidelines](process/tilt/normative-references.md) +- [Processing of Formal Objections](council/council.md) +- [Continuity of Operations under Travel Restrictions](meetings/continuity.md) -#### Patent Policy {#patents} +### Patent Policy {#patents} -- [W3C Patent Policy](/policies/patent-policy/) +- [W3C Patent Policy](https://www.w3.org/policies/patent-policy/) - Commentary: [FAQ](https://www.w3.org/2003/12/22-pp-faq.html), [Summary](https://www.w3.org/2004/02/05-patentsummary.html), and [Business Benefits](https://www.w3.org/2004/03/pp-points-20040210.html) - Patent Policy Information about Groups and Disclosures can be found from the [Group pages](https://www.w3.org/groups/) - ...more questions? Contact the [PSIG](https://www.w3.org/2004/pp/psig/) -#### Test Suites {#testsuites} +### Test Suites {#testsuites} -- Start with [web-platform-tests](http://web-platform-tests.org/), home for the Open Web test suites (including W3C ones). -- All WPT contributions are licensed under the terms of the [3-Clause BSD License](https://github.com/web-platform-tests/wpt/blob/master/LICENSE.md). For non-WPT test suites, see [Test suites licenses](/copyright/test-suites-licenses/)for Contribution of Test Cases +- Start with [web-platform-tests](https://web-platform-tests.org/) (WPT), home for the Open Web test suites (including W3C ones). +- All WPT contributions are licensed under the terms of the [3-Clause BSD License](https://github.com/web-platform-tests/wpt/blob/master/LICENSE.md). For non-WPT test suites, see [Test suites licenses](https://www.w3.org/copyright/test-suites-licenses/) for Contribution of Test Cases - ...more questions about the testing infrastructure? Contact [public-test-infra@w3.org](https://lists.w3.org/Archives/Public/public-test-infra/) -#### Process {#processdoc} +### Process {#processdoc} -- [Operative W3C Process Document](/policies/process/) -- [Guidelines to suspend or remove participants from groups](process/suspension.html) -- [Guidelines for disciplinary action](process/suspension.html) -- [Antitrust and Competition Guidance](/policies/antitrust/) +- [W3C Process Document](https://www.w3.org/policies/process/) +- [Guidelines to suspend or remove participants from groups](process/suspension.md) +- [Guidelines for disciplinary action](process/suspension.md) +- [Antitrust and Competition Guidance](https://www.w3.org/policies/antitrust/) - [Ongoing process issues](https://github.com/w3c/process/issues). Discussion happens in the context of the [W3C Process Community Group](https://www.w3.org/community/w3process/). - ...more questions? Contact the [Advisory Board](https://www.w3.org/groups/other/ab/) {:#suspension} -**Note on Member Submissions:**Per [section "Scope of Member Submissions" of the Process Document](/policies/process/#SubmissionScope), "when a technology overlaps in scope with the work of a chartered Working Group, Members SHOULD participate in the Working Group and contribute the technology to the group's process rather than seek publication through the Member Submission process." Read more about [how to send a Member Submission request](https://www.w3.org/submissions/guide/). +**Note on Member Submissions:** Per [section "Scope of Member Submissions" of the Process Document](https://www.w3.org/policies/process/#SubmissionScope), "when a technology overlaps in scope with the work of a chartered Working Group, Members SHOULD participate in the Working Group and contribute the technology to the group's process rather than seek publication through the Member Submission process." Read more about [how to send a Member Submission request](https://www.w3.org/submissions/guide/). ## Collected Wisdom, Advice {#sa34} -*Many of these resources were contributed by your colleagues; we invite you to write down and share your experiences as well. Discussion of issues that groups face take place on the chairs mailing list (Member-only [archive](https://www.w3.org/Archives/Member/chairs)). You may also find [chairs meetings back to 1997](chair/meetings)an interesting source of wisdom.* +*Many of these resources were contributed by your colleagues; we invite you to write down and share your experiences as well. Discussion of issues that groups face take place on the chairs mailing list (Member-only [archive](https://www.w3.org/Archives/Member/chairs/)). You may also find [chairs meetings back to 1997](chair/meetings.md) an interesting source of wisdom.* -#### Roles {#roles} +### Roles {#roles} -- [Chair's role](chair/role.html); [Guidance for Multiple Chairs](https://www.w3.org/wiki/MultipleChairs) -- [Editor's role](editor/role.html), [Editor, Author, Contributor Policies](https://www.w3.org/Signature/Contributor.html) -- [team contact's role](teamcontact/role.html) -- [Liaison's role](teamcontact/liaison-role.html). **Note:**Per [section "Liaisons"](/policies/process/#Liaisons)of the Process Document, liaisons MUST be coordinated by the Team due to requirements for public communication; patent, copyright, and other IPR policies; confidentiality agreements; and mutual membership agreements. -- [Advisory Committee Representative](https://www.w3.org/Member/faq.html)(Member-only) -- [Guidelines for communicating as a member of a W3C elected body](other/elected-body-communication-guidelines.html) +- [Chair's role](chair/role.md); [Guidance for Multiple Chairs](https://www.w3.org/wiki/MultipleChairs) +- [Editor's role](editor/role.md), [Editor, Author, Contributor Policies](https://www.w3.org/Signature/Contributor.html) +- [Team Contact's role](teamcontact/role.md) +- [Liaison's role](teamcontact/liaison-role.md). **Note:** Per [section "Liaisons"](https://www.w3.org/policies/process/#Liaisons) of the Process Document, liaisons MUST be coordinated by the Team due to requirements for public communication; patent, copyright, and other IPR policies; confidentiality agreements; and mutual membership agreements. +- [Advisory Committee Representative](https://www.w3.org/Member/faq.html) *(Member-only)* +- [Guidelines for communicating as a member of a W3C elected body](other/elected-body-communication-guidelines.md) -#### Advice on Meetings, Decisions, Issue Tracking {#mtg-advice} +### Advice on Meetings, Decisions, Issue Tracking {#mtg-advice} -- [ESW Wiki](https://www.w3.org/wiki/FrontPage)patterns: [MidwestWeeklyAgenda](https://www.w3.org/wiki/MidwestWeeklyAgenda), [MeetingRecords](https://www.w3.org/wiki/MeetingRecords), [TrackingIssues](https://www.w3.org/wiki/TrackingIssues) -- Doing a [Hybrid Group Meeting](meetings/hybrid-meeting) +- [W3C Wiki](https://www.w3.org/wiki/) patterns: [MidwestWeeklyAgenda](https://www.w3.org/wiki/MidwestWeeklyAgenda), [MeetingRecords](https://www.w3.org/wiki/MeetingRecords), [TrackingIssues](https://www.w3.org/wiki/TrackingIssues) +- Doing a [Hybrid Group Meeting](meetings/hybrid-meeting.md) - [The Seven Sins of Deadly Meetings](https://www.fastcompany.com/26726/seven-sins-deadly-meetings) -#### Historical {#historical} +### Historical {#historical} -- [W3C XML Specification DTD - (XMLspec)](https://www.w3.org/2002/xmlspec/), by Norman Walsh. +- [W3C XML Specification DTD (XMLspec)](https://www.w3.org/2002/xmlspec/), by Norman Walsh. {:#xmlspec} - [XMLSpec diff generation](https://www.w3.org/2008/05/xmlspec-diff-generation/) - QA resources: [Specification Guidelines](https://www.w3.org/TR/qaframe-spec/), [Handbook for QA in groups](https://www.w3.org/TR/qa-handbook/), and [QA Framework primer](https://www.w3.org/QA/WG/qaframe-primer) -- [HTML Slidy](https://www.w3.org/Talks/Tools/Slidy2/)for slide presentations +- [HTML Slidy](https://www.w3.org/Talks/Tools/Slidy2/) for slide presentations -#### Advice on Specification Development {#spec-advice} +### Advice on Specification Development {#spec-advice} - Most popular editing tools: [Bikeshed](https://speced.github.io/bikeshed/), [respec](https://github.com/speced/respec/wiki) - [W3C Manual of Style](manual-of-style/) - [Tips for getting to Recommendation faster](https://www.w3.org/2002/05/rec-tips) -#### GitHub {#GitHub} +### GitHub {#GitHub} - [W3C on GitHub](https://w3c.github.io/) - [Using GitHub for W3C specifications (slides)](https://www.w3.org/2015/Talks/1217-github-w3c/) - [Using GitHub for Spec Work (documentation)](https://tobie.github.io/specs-on-github/) -- [GitHub Repository Manager](https://labs.w3.org/hatchery/repo-manager/): One interface to find all group github contributors and the IPR status -- [Github repo activity digest](https://lists.w3.org/Archives/Member/chairs/2016OctDec/0100.html)(Member-only) -- [Adds preview and diff links to pull requests](https://lists.w3.org/Archives/Public/spec-prod/2017JanMar/0047.html)( [Config Helper](https://tobie.github.io/pr-preview/config.html)) +- [GitHub Repository Manager](https://labs.w3.org/hatchery/repo-manager/): One interface to find all group GitHub contributors and the IPR status +- [PR Preview - Adds preview and diff links to pull requests](https://lists.w3.org/Archives/Public/spec-prod/2017JanMar/0047.html) ([Config Helper](https://tobie.github.io/pr-preview/config.html)) ## About the Guidebook {#care-and-feeding} -This Guidebook is intended to complement the [W3C Membership Agreement](https://www.w3.org/Consortium/Agreement/Appendix)and the [W3C Process](/policies/process/). This index page is **Public**, although a small number of resources linked from this page may be visible only to the W3C Membership or Team. +This Guidebook is intended to complement the [W3C Membership Agreement](https://www.w3.org/Consortium/Agreement/Appendix) and the [W3C Process](https://www.w3.org/policies/process/). This page is **Public**, although a small number of resources linked from this page may be visible only to the W3C Membership or Team. -You are expected to be familiar with the parts of this Guidebook that affect your work. Working Group chairs should get a "tour" from their team contact. Then take a look again, for example, if you're going to hold a face-to-face meeting; read the [section on meetings](#Meetings)to be sure you understand what's written there, and to record any valuable knowledge you pick up along the way. +You are expected to be familiar with the parts of this Guidebook that affect your work. Working Group chairs should get a "tour" from their team contact. Then take a look again, for example, if you're going to hold a face-to-face meeting; read the [section on meetings](#Meetings) to be sure you understand what's written there, and to record any valuable knowledge you pick up along the way. -As editor of the guidebook, [@w3c/guidebook](https://github.com/orgs/w3c/teams/guidebook)will do its best to see that it gets better over time. This does *not*mean that we do all the editing ourselves! +As editor of the guidebook, [@w3c/guidebook](https://github.com/orgs/w3c/teams/guidebook) will do its best to see that it gets better over time. This does *not* mean that we do all the editing ourselves! -**Note:**Not all pages are maintained with the same frequency. Some may be quite outdated. Please add your issues to the [GitHub repository of this Guidebook](https://github.com/w3c/Guide/issues)if you have any specific comments and/or proposals to improve this Guidebook. +**Note:** Not all pages are maintained with the same frequency. Some may be quite outdated. Please add your issues to the [GitHub repository of this Guidebook](https://github.com/w3c/guide/issues) if you have any specific comments and/or proposals to improve this Guidebook.