entstate-648 Wordsmith - various (A, B, C, G, H)

hi

Rest of #648 to be sent in separate email.

<Juergen>
a) Section says:

Usage state indicates whether or not the entity is in use at a
specific instance, and if so, whether or not it currently has spare
capacity to serve additional users. In the context of this MIB, the
user is equivalent to an entity, so this term is substituted. This
state refers to the ability of the entity to service other entities
within its containment hierarchy.

I think this can be made shorter without loosing significance:

Usage state indicates whether or not the entity is in use at a
specific instance, and if so, whether or not it currently has spare
capacity to serve additional users. In the context of this MIB, the
usage state refers to the ability of an entity to service other 
entities within its containment hierarchy.

But I do not feel strongly about this change. (I just found the
term substitution a bit awkward.)
</Juergen>

I read this a number of times before seeing the difference, but a UNIX diff
showed me that you combined the last two sentences

< user is equivalent to an entity, so this term is substituted. 
< This
< state refers to the ability of the entity to service other entities
< within its containment hierarchy.
---
> usage state refers to the ability of an entity to service other 
> entities within its containment hierarchy.

I suggest we make this change. 

<Juergen>
b) I suggest to replace 'status' with 'states' in the sentence below:

In addition to those alarm status defined in
X.731 [X.731], warning and indeterminate status are also defined to
provide a more complete mapping to the Alarm MIB [Alarm-MIB].
</Juergen>

I suggest we make this change.

<Juergen>
c) I suggest to remove the following sentence from section 2.1:

This raises some interesting issues not addressed
in existing work on state management [X.731].

Rationale: Only one issue is mentioned and not multiple and it is
not really relevant whether X.731 addresses the same issue or not.'
</Juergen>

I propose then that we remove the reference to X.731 and keep the rest of
the sentence. The fact that the addition of hierarchy to the concept of
state is not well understood is an important note given it precedes a
statement indicating that this computed state is out of scope.

<Juergen>
g) In the ENTITY-STATE-TC module, replace

This MIB defines a state textual conventions.

with

This MIB defines state textual conventions.
</Juergen>

I suggest we make this change.

<Juergen>
h) You may want to decide where you like spaces between the name of
and enumerated number and the value or not. Right now, this is done
differently throughout the module.
</Juergen>

Propose consistently putting a space.

Sharon Chisholm
Nortel Networks
Ottawa, Ontario
Canada