Re: [whatwg/url] Explain how syntax relates to the parser for hosts and URLs (#228)

Thoughts thus far:

* A sibling section to "Parsers" doesn't really work since syntax doesn't require infrastructure. A "syntax violation" is really a parser concept since only the parser calls them out.
* If we start renaming syntax to "Valid URLs" or "URL validity" we'd need a whole lot of accompanying changes. We'd also no longer match how HTML talks about this. I'm not sure that's an improvement.
* I'm not entirely convinced the confusion is as widespread as it's made to appear. There are indeed a couple of folks with a shared background who are confused, but we've had that with HTML as well and as time passed those objections passed.

So I'm not entirely sure if I want to make more drastic changes at this point.

Things I'm open to doing:

* Add a non-normative paragraph at the start of the syntax sections explaining who they are for, similar to what HTML does.

-- 
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/url/pull/228#issuecomment-278337076