Welcome to the repository of the Web Sustainability Guidelines (WSG).
If you would like to learn more about us and how to participate in this project, please check the readme in the W3C Sustainable Web Interest Group repository.
- 94 Guidelines covering UX, Web Development, DevOps, & Business / Product Strategy.
- 254 Success Criteria to meet the guidelines on various aspects of sustainability.
- 100+ contributors from over 20 nations around the world.
The chartered focus of the W3C Sustainable Web Interest Group is the development of the Web Sustainability Guidelines (WSG) and its supplements.
Links to relevant documents (based on the CG Draft Report) can be found below.
Guidelines:
| Name | Status | Date |
|---|---|---|
| Web Sustainability Guidelines (WSG) | W3C Editors Draft | 06 Dec 2024 |
Other Deliverables:
| Name | Status | Date |
|---|---|---|
| Sustainable Tooling And Reporting (STAR) | W3C Editors Draft | 06 Dec 2024 |
| WSG At A Glance | W3C Editors Draft | 06 Dec 2024 |
| Introduction to Web Sustainability | W3C Editors Draft | 06 Dec 2024 |
| Web Sustainability Laws & Policies | W3C Editors Draft | 06 Dec 2024 |
| Quick Reference for WSG & Checklist (PDF) | W3C Editors Draft | 06 Dec 2024 |
| WSG JSON API | JSON API | 06 Dec 2024 |
| STAR Test Suite | Test Suite | 11 Apr 2024 |
Our schedule (and any associated goal deadlines) has yet to be determined, however we will still consider the remaining proposed and planned updates carried forward from the Sustainable Web Community Group (based on both W3C and CG member feedback).
Work is planned in accordance with the issues requiring resolution.
If you would like to contribute towards this specification, please refer to the CONTRIBUTING.md document for details and refer to the guidance on the W3C Sustainable Web Interest Group repository readme regarding participation.
Further guidance will be published in due course.
We have a JSON API which is kept in sync with the changes occurring within our specification.
This document is reachable via GitHub pages and can be queried using JavaScript to embed our data within your client of choice.
The structure of the API is identical to that of the specification in its numbering scheme:
category[1][0].guideline = "Undertake Systemic Impacts Mapping"
We have a Test Suite which is used to showcase machine testability (as denoted in STAR) for the Web Sustainability Guidelines (WSGs). The template structure for the file uses common W3C conventions for test cases to maintain interoperability for tooling that wishes to align our work with their own.
Key concepts of note include:
- Each title element contains a short identifier for the test.
- The rel="author" link element contains details of who created that test.
- The rel="help" link element links to the WSG guideline it relates to.
- The name="flags" meta element identifies any requirements the test may have such as an external file (asset), scripting (JavaScript), user-involvement (interaction), or if it's trying to disprove something (invalid).
- The name="assert" meta tag explains which STAR technique it relates to by title.
- The conditions of passing are what requirements are necessary to pass the technique (and thus the success criteria).
Below are some handy links for contributors to our project:
- Charter Template (HTML Source)
- GRI Notebook (Spreadsheet)
- How to do Wide Review
- Policies & legal information
- Pubrules documentation
- QA Framework
- Repository Templates
- ReSpec Documentation
- STAR Testability
- TAG Explainers
- Title Case Converter
- The Art of Consensus
- W3C Manual of Style
- W3C Process for Busy People