Skip to main content

Telechat Review of draft-ietf-nmop-terminology-19
review-ietf-nmop-terminology-19-artart-telechat-bray-2025-06-30-00

Request Review of draft-ietf-nmop-terminology
Requested revision No specific revision (document currently at 23)
Type Telechat Review
Team ART Area Review Team (artart)
Deadline 2025-08-05
Requested 2025-06-27
Authors Nigel Davis , Adrian Farrel , Thomas Graf , Qin Wu , Chaode Yu
I-D last updated 2025-09-03 (Latest revision 2025-08-18)
Completed reviews Secdir Early review of -07 by Hilarie Orman (diff)
Genart Early review of -07 by Paul Kyzivat (diff)
Opsdir Early review of -07 by Jouni Korhonen (diff)
Rtgdir Early review of -07 by Stewart Bryant (diff)
Iotdir Early review of -07 by Carsten Bormann (diff)
Intdir Early review of -07 by Dirk Von Hugo (diff)
Iotdir IETF Last Call review of -12 by Carsten Bormann (diff)
Genart IETF Last Call review of -10 by Paul Kyzivat (diff)
Secdir IETF Last Call review of -10 by Hilarie Orman (diff)
Artart IETF Last Call review of -17 by Tim Bray (diff)
Artart Telechat review of -19 by Tim Bray (diff)
Assignment Reviewer Tim Bray
State Completed
Request Telechat review on draft-ietf-nmop-terminology by ART Area Review Team Assigned
Posted at https://mailarchive.ietf.org/arch/msg/art/aCu6zDzmqRxq2tbTE3HUs7z7OaY
Reviewed revision 19 (document currently at 23)
Result Ready w/nits
Completed 2025-06-30
review-ietf-nmop-terminology-19-artart-telechat-bray-2025-06-30-00
Once again, gripes from this non-networking specialist may be irrelevant if the
language would be clear touch a specialist.

I do have one problem with this document, the lack of examples. I mentioned
this before and Adrian's reply was "I am usually a fan of examples, but in this
case I'm cautious. The risk is that the examples are taken to be limiting."  I
take his point but still disagree. Yes, it's hard to come up with quality
examples, but I believe the work is worthwhile. First, there is risk that
difficulty in offering examples might be a symptom of insufficient specificity
in the normative text. Second, and speaking for myself, I know that when I'm
having trouble understanding technical text the first thing I do is go looking
for examples.

3.1 "The terms may be viewed as a cascaded sequence of processes” - Hmm, terms
aren’t usually processes?

3.1 "Network monitoring - This is the process of keeping a continuous record of
functions related to a network topology.”  This sentence is hard to parse. Do
you mean something like “the functioning (or behavior?) of a running network”.
"Topology" doesn't seem quite the right word.

3.2 “Event”. Can an Event be anything other than the observation of a change? 
Troubled by the notion of anything that changes in a “negligible” delta-t.
Examples would help here.

I really don’t understand the difference between Condition and State, and
memory shortage being included in both definitions isn’t helping.

Occurrence, typo, missing verb: “That is, Occurrences, themselves a recursive
concept”