W3C home > Mailing lists > Public > public-browser-tools-testing@w3.org > July to September 2019

Working Group Visibility and Spec Documentation

From: Christian Bromann <christian.bromann@saucelabs.com>
Date: Tue, 24 Sep 2019 13:42:20 +0200
Message-Id: <1F6AE3C6-C0FE-4AD6-90B8-B4AA589902B0@saucelabs.com>
To: public-browser-tools-testing@w3.org
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.

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
mailing list
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?

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

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:09:57 UTC