Creating a PR: Building and previewing documents

Document build

You can build the understanding and technique documents locally.

The main spec is done separately (with Respec), this is only for the informative docs.

Eleventy Process (introduced July 2024)

See https://github.com/w3c/wcag/tree/main/11ty#usage for full instructions on installation and previewing locally.

The short version:

1. Install Node.js (preferably v20, the current LTS)
2. Run npm i in the root of the repository
3. Run npm start for a local development server, or npm run build to generate all files under _site

Ant Process (removed)

As of August 2024, the Ant/XSLT process for building informative documentation has been removed, as there are now features taking advantage of Eleventy that are no longer backwards-compatible.

Online Previews of Informative Docs

Pull requests now include automatic Netlify previews. As there is no top-level index page, you will need to append /techniques/ or /understanding/ to the deploy preview URL.