search

speced / bikeshed

:bike: A preprocessor for anyone writing specifications that converts source files into actual specs.
https://speced.github.io/bikeshed
Creative Commons Zero v1.0 Universal
1.09k stars 199 forks source link

Add more metadata for editors: retiredDate and notes #2053

Open jyasskin opened 3 years ago

jyasskin commented 3 years ago

Respec allows a retiredDate field for editors, which helps avoid mistakes where people put their editing dates inside the company name (e.g. https://github.com/w3c/uievents/blob/ebe787dfc0ef02b101f0694b96158636334226c1/index.bs#L16). It also allows a note field to avoid other kinds of notes winding up inside the company (https://github.com/w3c/ServiceWorker/blob/e00515361d1e69e35a880491297453715bbcda13/docs/index.bs#L9).

These mistakes aren't very common, so it could make sense to give this a low priority.

tabatkins commented 3 years ago

Hmm, interesting, the Editor field is getting kinda structure-ful.

marcoscaceres commented 3 years ago

Just ran into this also... an alternative approach might be to have a new to level entry that is just "FormerEditor:. Although it won't solve for some of the issues @jyasskin mentioned above, it at least gives the possibility to split device active/former Editors into their own <dt><dd> groups in the header.

jyasskin commented 3 years ago

That piece is already there: https://tabatkins.github.io/bikeshed/#metadata-former-editor

marcoscaceres commented 3 years ago

Ah, thank you! Sorry I missed that.