Collaboration on the specs

Hi all,

As discussed, I rearranged the specs in a single repository [1]. However, the annotations on hypothesis.io are now orphans (the page no longer exists). I moved some of the comments to issues, but this may be a problem moving forward. I discussed this in [2], but I wanted to have a general discussion on this aspect here.

I see three options (but feel free to propose others):


  1.
We stick to GitHub and Emails only for discussion (small comments can be made on GitHub files using the add comment on commits function)
  2.
We keep hypothesis.io assuming there will be no changes to the URLs of the specs from now on
  3.
We move the content of the specs to Markdown and develop a simple build system to generate the HTML versions — the idea is that we can comment on the Markdown using GitHub comments and that it is easier than doing the same on HTML.

WDYT?

Best,

Enrico

[1] https://github.com/w3c-facade-x/facade-x-specs
[2] https://github.com/w3c-facade-x/facade-x-specs/issues/4


--
Enrico Daga, PhD
Senior Research Fellow
Knowledge Media Institute
The Open University
http://enridaga.net
http://sparql-anything.cc

Received on Tuesday, 31 March 2026 09:59:16 UTC