This directory contains command line utilities intended for use by spec editors and contributors when authoring or reviewing changes.

• reformat-js.py - applies clang-format to JavaScript blocks in the spec.
• lint.mjs - analyses the spec Bikeshed source and generated HTML to look for common errors like duplicate words or unclosed links, and helps enforce the coding conventions.

The tools assume a POSIX-like command line environment, and have dependencies on various languages and libraries. Read the sources for more details.

Node.js dependencies can be installed/updated by running npm install from within the tools/ directory:

cd tools
npm install
cd ..

Spec editors can use a flow like the following:

# Edit the spec, save changes:
$EDITOR index.bs

# Reformat JS blocks:
python3 tools/reformat-js.py

# Build the spec:
bikeshed --die-on=fatal spec index.bs

# Check for common errors:
node tools/lint.mjs

# If no issues were reported, commit the changes:
git commit -a -m "made it more awesome"