ietf-ivy-wg / network-inventory-yang

Other
0 stars 3 forks source link

Clarify RFC8348 container terminology #13

Open italobusi opened 1 year ago

italobusi commented 1 year ago

The comment is not related specifically to this sentence, but it is related in general to "container". I've noticed this term is never defined in the document. Shouldn't we add that?

_Originally posted by @sergiobelotti in https://github.com/ietf-ccamp-wg/ietf-network-inventory/pull/51#discussion_r1001641252_

could we change this sentence to "Openconfig-platform data model is NE-level and uses a generic component concept to describe its inner equipment and holders, which is similar to ietf-hardware model..."? In the terminology of component at the beginning, component is also refer to equipment and holders.

_Originally posted by @YuChaode in https://github.com/ietf-ccamp-wg/ietf-network-inventory/pull/51#discussion_r1003263854_

italobusi commented 5 months ago

2024-01-17 Network Inventory weekly call

sergiobelotti commented 5 months ago

2024-01-17 Network Inventory weekly call

  • [ ] @sergiobelotti provide some text proposal to clarify the use of term container within this document

For my AP , this is a proposed text to add in our inventory base draft:

" Within this document , with the term "container" we consider an hardware component class capable of containing one or more removable physical entities, e.g. a slot in a chassis is containing a board. "

italobusi commented 5 months ago

2024-01-24 Base Network Inventory weekly call

  • [x] @sergiobelotti provide some text proposal to clarify the use of term container within this document

The term 'container' may have a broader meaning that the term 'holder', including bins, cabinets, ...

However, in the context of RFC8348 and in the context of components defined in the base inventory model, the term 'container' and 'holder' look synonymous

Agreed to use the term 'container' in this document, providing a definition as proposed in github and add an appendix with a terminology mapping to show e.g., that the term 'container' in this draft maps with the term 'holder' in other models

The terms 'container component' or 'YANG container' can also be used when needed to avoid confusion/ambiguity.