https://github.com/w3c/sustainableweb-wsg

Web Sustainability Guidelines (WSG)
https://github.com/w3c/sustainableweb-wsg

guidelines sustainability

Last synced: 2 days ago
JSON representation

Web Sustainability Guidelines (WSG)

Host: GitHub
URL: https://github.com/w3c/sustainableweb-wsg
Owner: w3c
License: other
Created: 2024-11-14T15:10:41.000Z (7 months ago)
Default Branch: main
Last Pushed: 2025-04-28T13:46:04.000Z (about 2 months ago)
Last Synced: 2025-04-28T14:47:17.610Z (about 2 months ago)
Topics: guidelines, sustainability
Language: HTML
Homepage: https://w3c.github.io/sustainableweb-wsg/
Size: 11.8 MB
Stars: 16
Watchers: 24
Forks: 4
Open Issues: 12
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        # Web Sustainability Guidelines (WSG)

Welcome to the repository of the [Web Sustainability Guidelines (WSG)](https://w3c.github.io/sustainableweb-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](https://github.com/w3c/sustainableweb-ig) repository.

## Statistics

 - **92** Guidelines covering UX, Web Development, Infrastructure, and Business / Product Strategy.

 - **254** Success Criteria to meet the guidelines on various aspects of sustainability.

 - **160** advisory Techniques within STAR providing guidance to meet WSG Success Criteria.

 - **2,500+** Resources (URLs) to reinforce and assist with implementation of WSG guidelines.

 - **150+** contributors from over **20** nations around the world.

## Work

The chartered focus of the [W3C Sustainable Web Interest Group](https://www.w3.org/groups/ig/sustainableweb/) is the development of the Web Sustainability Guidelines (WSG) and its deliverables.

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

			04 June 2025

		

	

**Other Deliverables:**

	

		

			Name

			Status

			Date

		

	

	

		

			Sustainable Tooling And Reporting (STAR)

			W3C Editors Draft

			04 June 2025

		

		

			Resources for WSG

			W3C Editors Draft

			04 June 2025

		

		

			Web Sustainability Laws and Policies

			W3C Editors Draft

			04 June 2025

		

		

			Introduction to Web Sustainability

			W3C Editors Draft

			04 June 2025

		

		

			WSG At A Glance

			W3C Editors Draft

			04 June 2025

		

		

			Quick Reference for WSG and Checklist (PDF)

			W3C Editors Draft

			17 May 2025

		

		

			WSG JSON API

			JSON API

			04 June 2025

		

		

			STAR JSON API

			JSON API

			04 June 2025

		

		

			STAR Test Suite

			Test Suite

			04 June 2025

		

	

## Schedule

	

		

			Name

			Date

		

	

	

		

			Initial Draft

			30 June 2025

		

		

			Final Draft

			31 December 2025

		

		

			Measurability

			31 Mar 2026

		

		

			W3C Draft Note

			22 Apr 2026 (Earth Day)

		

		

	

**Note:** We will still consider the [remaining proposed and planned updates](https://docs.google.com/presentation/d/1dcuSMLcAF8jTHNCovOfs31zrjCr3rtrwzTXRLSy3lAk/edit?usp=sharing) carried forward from the Sustainable Web Community Group (based on both W3C and CG member feedback).

## Processes

Work is planned in accordance with the [issues](https://github.com/w3c/sustainableweb-wsg/issues) requiring resolution.

If you would like to contribute towards this specification, please refer to the [CONTRIBUTING.md](IG-CONTRIBUTING.md) document for details and refer to the guidance on the [W3C Sustainable Web Interest Group](https://github.com/w3c/sustainableweb-ig) repository readme regarding participation.

## JSON APIs

We have two JSON APIs which are kept in sync with the changes occurring within our [specification](https://w3c.github.io/sustainableweb-wsg/guidelines.json) and [STAR](https://w3c.github.io/sustainableweb-wsg/star.json).

These documents are reachable via GitHub pages and can be queried using JavaScript to embed our data within your client of choice.

**WSG** (*guidelines.json*)

```js

category[1].guidelines[0].guideline = "Display any variables that have a negative impact on your project"

```

**STAR** (*star.json*)

```js

category[1].techniques[0].title = "Produce a List of Variables To Monitor for Sustainability Impacts"

```

One method of reaching the API could be through code similar to the below (customize to your requirements):

```js

fetch("https://w3c.github.io/sustainableweb-wsg/guidelines.json")

  .then((res) => res.json())

  .then((data) => {

    console.log(`The First UX Guideline Title is ${data.category[1].guidelines[0].guideline}`); });

```

**Note:** To match a WSG guideline to a STAR technique, you can match the guideline `testable` anchor hash (WSG JSON API) to the technique `id` (STAR JSON API).

## Test Suite

We have a [Test Suite](https://github.com/w3c/sustainableweb-wsg/tree/main/test-suite) which is used to showcase machine testability (as denoted in [STAR](https://w3c.github.io/sustainableweb-wsg/star.html)) for the Web Sustainability Guidelines (WSG). 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).

## Resources

Below are some handy links for contributors to our project:

 - [Charter Template](https://w3c.github.io/charter-drafts/charter-template.html) ([HTML Source](https://github.com/w3c/charter-drafts/blob/gh-pages/charter-template.html))

 - [GRI Notebook](GRI.ipynb) ([Spreadsheet](https://docs.google.com/spreadsheets/d/12nGydnSv24fvmvCM-665_pFGPG9u3RgTwe1sCz4eiGk/edit?usp=sharing))

 - [How to do Wide Review](https://www.w3.org/Guide/documentreview/)

 - [Policies and legal information](https://www.w3.org/policies/)

 - [Pubrules](https://www.w3.org/pubrules/) ([Documentation](https://www.w3.org/pubrules/doc/))

 - [QA Framework](https://www.w3.org/TR/qaframe-spec/)

 - [Repository Templates](https://github.com/w3c/ash-nazg/tree/master/templates)

 - [ReSpec Documentation](https://respec.org/docs/)

 - [STAR Testability](https://docs.google.com/spreadsheets/d/1DKfIdm0mHkyzTVv41hogUdh41SnLkk9Uwkc8Nm6bqD4/edit?usp=sharing)

 - [TAG Explainers](https://tag.w3.org/explainers/)

 - [The Art of Consensus](https://www.w3.org/Guide/)

 - [W3C Manual of Style](https://www.w3.org/Guide/manual-of-style/)

 - [W3C Process for Busy People](https://github.com/w3c/wg-effectiveness/blob/main/process.md)

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/w3c/sustainableweb-wsg

Awesome Lists containing this project

README