Skip to content
This repository has been archived by the owner on Mar 15, 2021. It is now read-only.

[DEPRECATED] GitHub action to validate a ReSpec document and publish it using Echidna.

License

Notifications You must be signed in to change notification settings

w3c/respec-w3c-auto-publish

Repository files navigation

⚠ Deprecated: Use spec-prod instead.


ReSpec W3C Auto-Publish (GitHub Action)

GitHub action to validate a ReSpec document and publish it as a TR using Echidna.

The document is published only when a PR is merged. Validation is done when a PR is created/updated and merged.

Inputs

Working Group Chairs and W3C Team members can request a token directly from the W3C. This can then be saved as ECHIDNA_TOKEN in your repository settings under "Secrets".

Please see action.yml

Example Usage

You need two things:

  1. an "ECHIDNA" manifest file
  2. an action.yml file

ECHIDNA manifest file

The ECHINA manifest file needs live at the root of your repository and make sure it's accessible via GitHub pages!

Just change your-spec-shortname to whatever your spec's short name is.

index.html?specStatus=WD&shortName=your-spec-shortname respec

action.yml

Place this file in ".github/workflows/action.yml" (or some other filename if you'd like) and change things as appropriate for your spec.

name: Node CI

on:
  push:
    branches:
      - gh-pages # change to your default branch
  pull_request: {}

jobs:
  validate-and-publish:
    name: Validate and Publish
    runs-on: ubuntu-latest # only linux supported at present
    steps:
      - uses: actions/checkout@v2
      - uses: w3c/respec-w3c-auto-publish@v1 # use the action
        with:
          ECHIDNA_TOKEN: ${{ secrets.ECHIDNA_TOKEN }}
          ECHIDNA_MANIFEST_URL: "https://w3c.github.io/your_spec_repo/ECHIDNA"
          # Please use the URL that's appropriate for your working group!
          WG_DECISION_URL: "https://lists.w3.org/Archives/Public/public-webapps/2014JulSep/0627.html"
          CC: "foo@bar.com,bar@foo.com"
          CHECK_LINKS: true # Validate links and cross references; default: true
          VALIDATE_MARKUP: true # Validate HTML markup; default: true

WG_DECISION_URL

Here are some of the possible values of WG_DECISION_URL for various working groups:

WebApps WG
https://lists.w3.org/Archives/Public/public-webapps/2014JulSep/0627.html
Media Capture WG
https://lists.w3.org/Archives/Public/public-media-capture/2015Dec/0031.html
Second Screen WG
https://lists.w3.org/Archives/Public/public-secondscreen/2015Jun/0096.html
Web RTC
https://lists.w3.org/Archives/Public/public-webrtc/2016Mar/0031.html
Aria
https://lists.w3.org/Archives/Public/public-html-admin/2015May/0021.html
Device APIs
https://lists.w3.org/Archives/Public/public-device-apis/2015Oct/att-0037/minutes-2015-10-15.html#item05