search

w3c / wot-security

a repo exclusively for security to better manage issues and security considerations for WoT
https://w3c.github.io/wot-security/
18 stars 22 forks source link

Change "Local and Remote Proxy" to "Local and Remote Intermediary" #137

Closed takuki closed 4 years ago

takuki commented 5 years ago

This is for issue #123.

mmccool commented 4 years ago

This only changes the one sentence 

We refer to this configuration as a "Split Proxy" 
because the combination of the Local and Remote 
    Proxy 
together act like a single proxy service.

to

We refer to this configuration as a "Split Proxy" 
because the combination of the Local and Remote 
    Intermediary 
together act like a single proxy service.

but without changing the section header, or other instances of the word "proxy" in the same sentence (not to mention in the same paragraph). So... I think we need to do one of two things:

  1. Add an extra explanatory sentence saying why we use "Intermediary" and make consistent changes elsewhere
  2. Leave it alone.

I am inclined to option 2 for the third (pending) release in order not to delay publication, but we should consider further for the next release.

"Proxy" is an accepted term for what we are talking about, and a Proxy is just one kind of an Intermediary... so Proxy is simply more specific. We could just add a sentence instead that just says "Note that a proxy is one example of a WoT Intermediary as defined in [[WoT-Architecture]]". I would suggest doing this without changing anything else; that is, then we should keep on using "proxy" here, with the understanding that it is an example of an Intermediary.

mmccool commented 4 years ago

We decided in the 2019-11-05 we decided not to merge this PR, but in a future edit add a sentence noting that a proxy is a special case of an Intermediary.