bikeshed icon indicating copy to clipboard operation
bikeshed copied to clipboard

Move definition contrat to Spec Editors Community Group

Open dontcallmedom opened this issue 3 years ago • 3 comments

The bikeshed documentation is at the moment the authoritative place that specifies how definitions should be marked up.

This specification has now at least two consumer implementations (shepherd and reffy), and two or three producers (bikeshed, respec and at least some support from wattsi) and as part of our work on browser-specs and reffy, we have already identified possible clarifications needed: https://github.com/w3c/reffy/issues/336 and are interested in approaching other editing tools from other communities (TC39, IETF, Khronos) to gauge their interest in adopting it, which would probably involve expanding the taxonomy of definitions.

Given the recent launch of the Spec Editors Community Group, this would feel like a good host to maintain this definition contract as a document of its own. I'm happy to seed such a document if moving it away from the bikeshed documentation is acceptable.

cc @tidoust @marcoscaceres

dontcallmedom avatar Jun 17 '21 08:06 dontcallmedom

Yup, this sounds good to me. Is the SECG a GH org (in which case I can spin the contract out into a repo) or a repo under w3c (in which case I just need edit rights)?

tabatkins avatar Jun 18 '21 17:06 tabatkins

I've created https://github.com/speced/spec-dfn-contract/ - feel free to overwrite its history

dontcallmedom avatar Jun 21 '21 06:06 dontcallmedom

@tabatkins, I made a start at moving the contract over: https://github.com/speced/spec-dfn-contract/pull/10

Would be great to collaborate on it.

marcoscaceres avatar Aug 13 '21 06:08 marcoscaceres