Skip to content

Migrating spec‐generator usage to www.w3.org

Kenneth G. Franqueiro edited this page Feb 17, 2026 · 4 revisions

As of spec-generator 3.0, the service is now stable enough for us to move it away from labs. spec-generator is available at https://www.w3.org/publications/spec-generator/.

The old URL (https://labs.w3.org/spec-generator/) was retired on February 2, 2026.

Most existing scripts that rely upon spec-generator for ReSpec documents only need to change labs.w3.org/spec-generator to www.w3.org/publications/spec-generator; all existing parameters still work the same.

For example, if the old command were:

curl -F "file=@source.html" -F type=respec https://labs.w3.org/spec-generator/ > index.html

Then the new command would be:

curl -F "file=@source.html" -F type=respec https://www.w3.org/publications/spec-generator/ > index.html

Or, if the old command were:

curl https://labs.w3.org/spec-generator/?type=respec"&"url=https://raw.githack.com/ORG/REPO/main/index.html \
     -o _site/index.html -f

Then the new command would be:

curl https://www.w3.org/publications/spec-generator/?type=respec"&"url=https://raw.githack.com/ORG/REPO/main/index.html \
     -o _site/index.html -f

The only case where additional effort is required is if specific respecConfig properties were overridden within a POST request, which is fairly rare. This functionality is now achieved via parameters prefixed by md-.

For example, if the old command were:

curl -F "file=@source.html" -F type=respec -F specStatus=ED -F publishDate=2025-12-16 \
     https://labs.w3.org/spec-generator/ > index.html

Then the new command would be:

curl -F "file=@source.html" -F type=respec -F md-specStatus=ED -F md-publishDate=2025-12-16 \
     https://www.w3.org/publications/spec-generator/ > index.html

Clone this wiki locally