panrg / path-properties

A Vocabulary of Path Properties
Other
1 stars 3 forks source link

IRSG Review (Dave Oran): Editorial issues #94

Closed renghardt closed 1 year ago

renghardt commented 1 year ago

From the IRSG review by Dave Oran:

The Abstract says the “document specifies several path properties…”. I wonder if the descriptions of these in the main text in fact constitute a rigorous definition intended to be normative in other documents (i.e. ‘specified’) or informative only, in which case I’d suggest changing the wording to “document identifies several path properties…”

First sentence of introduction, suggest changing the wording to “…does not explicitly support endpoint discovery of forwarding paths through the network nor the discovery…”

For the first-time reader, it might be worth emphasizing in the introduction that the statement “the document lists several path properties” is not intended to be either exhaustive or definitive.

The last sentence of the definition of Path says “…these paths do not have to be disjoint.” A forward reference to your definition of Disjointness might be useful here.

In section 4, third paragraph. you say “…by aggregating them appropriately or dampening their changes to avoiding oscillation.” I don’t think you exactly mean this as you can’t actually damp the rate of change of the actual properties. Instead perhaps say “by aggregating them appropriately or applying a dampening function to their changes to avoid oscillation.”

A bit further down you say “..a NAT typically stays on a specific path”. Perhaps “a NAT typically stays on a particular path” since the path may not be “specific”.

This is probably unfair to a large community, but my view is that in the list of “access technologies “2G, 3G, 4G, or 5G” don’t really belong since those are basically marketing labels and not technologies. Can we get away with simply saying e.g., 3GPP cellular, or 802.11 WiFi”?

A bit further down you have the term “cellular backbone network”. I may be wrong, but I think that community instead uses the term “cellular core network”

In “Service Functions” you list “TCP Optimizers”. Might “TCP Performance Enhancing Proxies” be more appropriate for this context?

For “Administrative Domain” you say “…individual or an organization that owns a path element…” - I’m not sure ownership is the defining characteristic rather than perhaps “…individual or an organization that controls access to a path element…”

(At first glance, these all seem like editorial fixes that won't require much discussion. If you disagree that this is true for any of the above comments, please let me know.)