search

w3c / tr-pages

Work on the w3.org/TR index page (not specs themselves)
https://www.w3.org/TR/
26 stars 12 forks source link

TR page needs flow chart showing spec phases #15

Open tantek opened 6 years ago

tantek commented 6 years ago

When someone comes to TR, they have no idea what ED, FPWD, WD, CR, PR, REC, mean, their distinctions, where they are in the lifecycle etc. A simple flow chart would help e.g. see the tops of:

https://indieweb.org/Micropub https://indieweb.org/Webmention https://indieweb.org/WebSub for spec state specific diagrams

and perhaps something simple like this in any context where lists of WD/CR/PR/REC are shown:

https://indieweb.org/images/d/dc/w3c-spec-development-lifecycle.svg

(diagrams by @aaronpk)

tripu commented 6 years ago

@tantek, it's not exactly what you suggest, but I started drawing a flow chart to guide newbies (or anyone, really) in the process of publishing specs of any kind:

https://github.com/w3c/w3c.github.io/blob/tripu/flow-diagram/img/flow-diagram.svg

It's more oriented towards tools (Bikeshed, Respec, spec-generator, Specberus, Echidna, Link Checker, etc) than towards types or phases of specs. But perhaps we could combine both in the same diagram?