Working Group Visibility and Spec Documentation

Hey all,

After our F2F discussion at TPAC I took an action item home regarding improving the visibility of our work at W3C to be easier discoverable for others. Here is my proposal:

I looked what other WGs are doing and saw a general pattern of having a WG website with all information with the url https://w3.org/<wg-name>, e.g.
https://www.w3.org/webperf/
https://www.w3.org/sw/
https://www.w3.org/immersive-web/
https://www.w3.org/das/

The repositories for that are under the w3c org, e.g. https://github.com/w3c/web-performance/ <https://github.com/w3c/web-performance/>. Currently our WG site is available under https://www.w3.org/testing/browser/ <https://www.w3.org/testing/browser/> which is not much intuitive and also doesn’t contain much information about the WebDriver spec we are working on and other specs that reference to it.

So I would propose:
setting up a github repo for the wg website (e.g. https://github.com/w3c/bttwg <https://github.com/w3c/bttwg>)
have a website similar to https://www.w3.org/sw/ <https://www.w3.org/sw/> (e.g. https://www.w3.org/btt/ <https://www.w3.org/btt/>)
include all important information from the WG including:
Working group mission
GitHub
mailing list
CoC
links to specs and others
A tutorial on how to write WPT
have a swagger editor (like https://editor.swagger.io/) with all WebDriver endpoints for easier discoverability
I already ported our spec into such swagger definition: https://app.swaggerhub.com/apis-docs/christian-bromann/webdriver/2.0.0 <https://app.swaggerhub.com/apis-docs/christian-bromann/webdriver/2.0.0>
have it all setup under https://www.w3.org/btt/ <https://www.w3.org/btt/> or maybe https://www.w3.org/webdriver/ <https://www.w3.org/webdriver/>
icymi: a while ago I claimed the webdriver user/org on github: https://github.com/webdriver .. we might can use that too but I guess it all needs to be under the W3C org. However I see other WGs having their stuff in a different github org e.g. https://github.com/immersive-web <https://github.com/immersive-web>.

I am happy to build together the website.

What do you all think?

Cheers
Christian

Received on Tuesday, 24 September 2019 11:49:00 UTC