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

Hi @rubys, I'm glad you're willing to put those misunderstandings behind us and move forward with this.

We do need to figure out the matter of terminology you mentioned. Let me ask this question. I see two possibilities:

- The two sets of terminology are equivalent, i.e., they form a set of synonym pairs used in two different technology domains.
- There is a meaningful difference between the two sets, so that, for example, there is a (perhaps subtle) difference between the meanings of protocol and scheme, between query and search, and between fragment and hash.

If the first case is true, then perhaps each box of the diagrams could include both terms, i.e., it would be bilingual.
If the second case is true, perhaps this brings up your suggestion of different graphics in different sections. But would it also be possible to have diagrams that express the relationship between the two terminologies, so that people could understand that relationship instead of looking at them in isolation from each other?

Regarding a web page that displays a candidate of something to go in the Standard, I'd like to suggest that we're talking about something on the spectrum between [my diagram](https://github.com/whatwg/url/issues/337#issuecomment-421627310) and [your diagrams](http://intertwingly.net/projects/pegurl/url.html#rule-url). One problem with my diagram is that it doesn't include the case of relative URLs. But what I like about my diagram is that it summarizes the whole sequence of absolute URLs in one diagram (albeit with a line break). Your diagrams go into much more detail and therefore cover the content of my diagram in at least four different diagrams, as listed [above](https://github.com/whatwg/url/issues/337#issuecomment-421801780). It seems that both approaches are worthwhile for seeing both the forest and the trees.

In addition to @rubys, it would be helpful if @annevk and anyone else chimes in if you ever feel that we're going off in a direction that's not going to work. It would be unpleasant for us to develop something, only to be told later it's not suitable.

-- 
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-423035654