[!WARNING] This Community Group's activities are now under the direction of the W3C Sustainable Web Interest Group. This includes the curation of the Web Sustainability Guidelines. Thank you for supporting us as we reached this stage in our journey and we hope you will continue to support our work as it develops at our new home (where you are welcome to get involved).

Note: If you are seeking an archived draft of our CG reports, please go to our releases page and download the Source code (zip archive) for the assets of a particular version you wish to see.

Web Sustainability Guidelines (WSGs)

Welcome to the repository for the Sustainable Web Design Community Group.

In this hub, you will find the draft specification for our Web Sustainability Guidelines and any supplementary documentation, including Sustainable Tooling And Reporting (STAR), our at-a-glance overview, our introduction to Web Sustainability, our sustainability laws & policies guide, our quick reference sheet, our PDF checklist, our JSON API, and our Test Suite. We also have a living implementation of the specification under active development called Sustainable Web Design.

If you would like a brief introduction to both our group and our specification, you may find the slides from the presentation we gave at TPAC 2023 useful. To learn more about our group, its goals, and our progress, check out our wiki, and frequently asked questions page.

Progress

Work is planned in accordance with our overview of the issues requiring resolution. Each milestone corresponds to a release published.

Note: W3C member feedback on our initial proposed Working Group charter has lead to many proposed and planned updates.

View current Interest Group chartering efforts: * The Current AC Poll. (W3C Members Only) * Our Proposed charter. (Feedback Welcome) * The latest editor's draft of our charter. (DIFF Changelog)

Contributing

If you would like to contribute towards this specification, please refer to the CONTRIBUTING.md document for details. It contains detailed information on pull requests (PRs), submitting issues, and other methods of feedback in relation to this repository.

Note: Please make your pull requests (including any changes or edits) against files ONLY located within the "drafts" or "ig" folders. Also, to make substantive contributions, you must join the CG.

You can also contribute at our monthly meetings. For details, see our calendar and meeting minutes.

JSON API

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"

Test Suite

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).