The mission of the W3C Documentation Community Group (W3C Docs CG) is to ensure web developers and designers worldwide have the best information available so they can build things on the web platform.
This community group will:
- Plan and write new documentation for web platform technologies.
- Make sure reference documentation (“the book of web platform features”) is complete.
- Identify needs for guides, how-tos, and tutorials, and create them.
- Work with specification authors to define best practices for web developer documentation, code examples, and information architecture.
- Maintain and keep documentation up-to-date using modern approaches like docs-as-code
- Develop tools to create feedback loops between standards and web developer documentation.
- Coordinate documentation efforts: Collaborate with other W3C community groups, such as WebDX, Security, Privacy, Accessibility, Internationalization, Sustainability and integrate their findings and best practices into documentation.
- Be a resource for resources: map documentation sources for web developers.
- Identify reliable sources of information.
- Invite them to be part of the conversations in this community group.
- Drive adoption (or deprecation) of web platform technologies:
- Identify web platform features where sparse docs prevent adoption and understanding.
- Interpret developer surveys (such as the MDN short survey on web developer’s experience with Web Security and understand the role of documentation in identified shortcomings.
- Ensure documentation relevance: coordinate horizontal efforts to get outdated docs updated such as by helping reach out to the right docs owners.
- Be a hub for web documentation: when docs-related efforts, changes, and/or projects appear, coordinate with the relevant stakeholders to get these amplified.
- Write and maintain docs in mdn/content. See the backlog for missing reference pages.
- Identify best practices for web developer documentation.
- Drive adoption and understanding of web technologies.
The group may produce Community Group Reports within the scope of this charter but not Specifications.
- Groups
- Open Web Docs
- Web Developer Experience (WebDX) Community Group
- Webref & spec tooling maintainers
- SWAG Community Group
- TAG (especially related to “explainers”)
- OWASP
- OSTIF
- Write The Docs
- ARIA Practices Guide Taskforce (a subgroup of ARIA WG) who owns/maintains APG.
- Docs sites
- MDN Web Docs
- CanIUse
- web.dev
- learn.microsoft.com
- devdocs.io
- Freecodecamp
- Popular front-end sites/blogs which also document the web, for example: css-tricks.com, w3schools, ...
- Translated docs, for example: Doka: web docs for Russian speaking developers
Who is this CG for?
- Technical writers and other documentation practitioners to collaborate.
- Web platform docs sites to share best practices.
- Specification authors and implementers to give and receive feedback on documentation and specs.
- Web developers to identify and request support to better the understanding of web platform technologies.