Re: [whatwg/url] Add a neato informative table of various URL pieces (#337)

@EnnexMB, I'm willing to help, but there seems to be some confusion.  For example, I don't believe that the railroad diagrams were ever meant to replace any existing sections, and if I ever gave that impression, I apologize.  Nor do I believe that they were meant to be normative (my memory is fuzzy on this point, perhaps they were initially proposed as such, but if so, we quickly determined that they were best non-normative.

Beyond that, there is an even bigger disconnect.  To illustrate, look at the original table and note that it uses the word `protocol`.  Now look at recent work, and see the word `scheme`.  I think the biggest problem here is determining who the target audience is for this change.  I gather that the original request was focused on users of the API.

I guess what I am getting at is that there may be multiple issues here, and they aren't mutually exclusive.  It may be worthwhile adding multiple graphics to different sections.

Finally, yes, I'm willing to help.  If you have something you would like to see in the document and can show it displaying in a web page, I can review it and do the command line magic to make pull request for you.  If what you produce addresses this issue, that's great.  But if not, that's not a problem either.

-- 
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/issues/337#issuecomment-422960916