This repository contains the source code of the W3C WebID Community Group (CG) processes and work items.
All substantive contributors to work items must be members of the WebID CG. It’s easy to join the CG if you’d like to contribute. Guests are welcome but do not have voting rights.
See the contributing guide for detailed instructions on how to get started with our project.
Work items are written using either BikeShed or ReSpec.
ReSpec is a JS library that unobtrusively allows editors to write a specification focusing on the actual features and correctness, while needing to pay as little attention as possible to issues pertaining to styling, referential integrity and W3C Publication Rules.
BikeShed is a preprocessor that automates a lot of modern spec-writing, taking in lightly-decorated Markdown and producing a full spec, with cross-spec autolinking, automatic generation of indexes/ToC and many other features.
Moving forward, all new work items and major revisions of existing work items should use BikeShed. BUILD.md contains a short guide on its usage.
An automated CI workflow using GitHub Actions takes care of
maintaining up-to-date builds of work items written with BikeShed.
The resulting .html documents are tracked in separate branches with the ci/
prefix prepended to the name of the originating branch.
All documentation, code and communication under this repository are covered by the W3C Code of Ethics and Professional Conduct.