A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

Web Sustainability Guidelines

The draft specification for our Web Sustainability Guidelines and any supplementary documentation, including our introduction to Web Sustainability.
https://github.com/w3c/sustyweb

Category: Consumption
Sub Category: Computation and Communication

Keywords

guidelines sustainability

Last synced: about 19 hours ago
JSON representation

Repository metadata

Sustainable Web Design Community Group

README.md

[!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:


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

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 5 days ago

Total Commits: 353
Total Committers: 8
Avg Commits per committer: 44.125
Development Distribution Score (DDS): 0.113

Commits in past year: 143
Committers in past year: 6
Avg Commits per committer in past year: 23.833
Development Distribution Score (DDS) in past year: 0.168

Name Email Commits
AlexDawsonUK 9****K 313
ianbjacobs ij@w****g 30
Tantek Çelik b****g@t****m 4
Łukasz Mastalerz m****z@g****m 2
Tzviya t****n@g****m 1
Tim Frick 1****k 1
Chris Augier c****r@g****m 1
Andrea Davanzo i****o@a****m 1

Committer domains:


Issue and Pull Request metadata

Last synced: 2 days ago

Total issues: 181
Total pull requests: 11
Average time to close issues: about 1 month
Average time to close pull requests: about 2 hours
Total issue authors: 35
Total pull request authors: 6
Average comments per issue: 3.36
Average comments per pull request: 1.73
Merged pull request: 8
Bot issues: 0
Bot pull requests: 0

Past year issues: 34
Past year pull requests: 8
Past year average time to close issues: 3 months
Past year average time to close pull requests: about 2 hours
Past year issue authors: 7
Past year pull request authors: 4
Past year average comments per issue: 2.15
Past year average comments per pull request: 2.0
Past year merged pull request: 8
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/w3c/sustyweb

Top Issue Authors

  • AlexDawsonUK (63)
  • airbr (15)
  • ldevernay (9)
  • DocRoms (8)
  • thibaudcolas (8)
  • jyasskin (7)
  • chrisn (6)
  • j9t (6)
  • gagarine (5)
  • www-diogo-in (4)
  • JamesChristie-SustainableUX (4)
  • JulienWilhelm (4)
  • tantek (4)
  • BezPowell (3)
  • marie-ototoi (2)

Top Pull Request Authors

  • tantek (3)
  • ianbjacobs (3)
  • JulienWilhelm (2)
  • andreadavanzo (1)
  • gaelduez (1)
  • augier (1)

Top Issue Labels

  • technical (67)
  • enhancement (55)
  • roadmap (40)
  • question (11)
  • invalid (5)

Top Pull Request Labels

  • technical (11)

Score: 7.294377299288822