Re: [whatwg/fetch] Convert to bikeshed (#398)

Thank you for working on this!

So I think I need to merge #383 before this is done at least since @jungkees has been at it for a while and we just finished the HTML side (it's rather small thankfully). Seems reasonable for other PRs to be adjusted post-merge since they haven't been super active.

> The conversion doesn't preserve all the ids yet; I'm not sure how critical that is.

Depends on the IDs. IDs for the reference section and items in it are fine, but IDs for definitions and the main sections should remain stable. Fetch has many incoming links.

> Bikeshed complains about the invalid IDL in the definition of HeadersInit and thus doesn't apply some of its magic to the fragment; not sure how that should be handled.

Don't mark it up as IDL for now. We'll fix this as part of #164.

> It also tries to interpret the 'self' in content policy as a CSS property description (and naturally fails to do so);

@mikewest probably knows how to fix this.

> It also warns about missing ids on examples and headings

Would it help if I made an editorial change to the standard to fix these beforehand?

> not optimizing it for author convenience which can hopefully be done at a later stage.

That sounds good. That makes the diff more readable.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/whatwg/fetch/pull/398#issuecomment-255663908

Received on Monday, 24 October 2016 07:09:13 UTC