html-differences icon indicating copy to clipboard operation
html-differences copied to clipboard

Convert to bikeshed

Open zcorpan opened this issue 9 years ago • 9 comments

cc @annevk

zcorpan avatar Nov 11 '16 09:11 zcorpan

See the last three commits here for guidance: https://github.com/whatwg/encoding/commits. Or look at Fullscreen.

annevk avatar Nov 11 '16 09:11 annevk

Adding IDs to headings, then renaming resources, than doing the rest, in three commits, is a rough summary of the process and has worked well thus far.

annevk avatar Nov 11 '16 09:11 annevk

Given the lack of updates to this document, maybe we should just can it altogether?

annevk avatar Mar 20 '17 16:03 annevk

We could maybe reach out to the mailing list and the blog first?

annevk avatar Mar 20 '17 16:03 annevk

Yeah... the target audience for this document is probably small enough today that it isn't worth the cost to maintain. Unless someone is interested in taking over as editor we should probably mark it as being a stale resource somehow.

zcorpan avatar Mar 20 '17 18:03 zcorpan

Is this the only document that still depends on whatwg/xref? I suspect we'll end up breaking some of that soon in HTML if we change how fragment-links works for instance. Is that a problem?

annevk avatar Apr 23 '17 05:04 annevk

I don't think so, particularly. If we want to maintain this we should finish conversion to bikeshed. If not, we'll still make sure existing links to HTML continue to work, right?

zcorpan avatar Apr 23 '17 06:04 zcorpan

Yeah, it would just be a problem if you wanted to generate a new html-generated.json.

annevk avatar Apr 23 '17 06:04 annevk

Though really I'd like to see whatwg/xref gone to avoid confusing folks. I just added a README that marks it obsolete, hopefully that helps.

annevk avatar Apr 23 '17 06:04 annevk