Hi Italo,

Please inline.

Cheers,
Med (as contributor)

De : Italo Busi <[email protected]>
Envoyé : mardi 29 avril 2025 17:03
À : [email protected]
Cc : TEAS WG <[email protected]>; [email protected]
Objet : [Teas] List identifiers in draft-ietf-netmod-rfc8407bis


Hi all,

Section 4.3.1 of draft-ietf-netmod-rfc8407bis-24 says:

List identifiers SHOULD be singular with the surrounding container name plural. 
Similarly, "leaf-list" identifiers SHOULD be singular.

This guideline seems valuable and reasonable in most of the cases but I have 
see a couple of similar exceptions which, IMHO, are worth considering

The issue is about cases where the list entry represents a set of parameters. 
For example in draft-ietf-ccamp-optical-impairment-topology-yang-18 we have the 
following list:

       +--ro roadm-path-impairments
       |  +--ro roadm-path-impairment* [roadm-path-impairments-id]
       |     +--ro roadm-path-impairments-id    string

The singular name for the list is a bit misleading since each entry represents 
a set of optical impairments parameters (e.g., CD, PMD, PDL).

[Med] Maybe use a name that better reflects the description at the first place:

        list roadm-path-impairment {
          key "roadm-path-impairments-id";
          description
            "The list of the set of optical impairments related to
            ROADM paths.";

For example (and also avoid repeating the prefix of parent nodes):

NEW:
       +--ro roadm-path-impairment-sets
       |  +--ro roadm-path-impairment-set* [id]
       |     +--ro id    string

For the other points in your message, I would update to follow the guidance in 
8407bis.


____________________________________________________________________________________________________________
Ce message et ses pieces jointes peuvent contenir des informations 
confidentielles ou privilegiees et ne doivent donc
pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu ce 
message par erreur, veuillez le signaler
a l'expediteur et le detruire ainsi que les pieces jointes. Les messages 
electroniques etant susceptibles d'alteration,
Orange decline toute responsabilite si ce message a ete altere, deforme ou 
falsifie. Merci.

This message and its attachments may contain confidential or privileged 
information that may be protected by law;
they should not be distributed, used or copied without authorisation.
If you have received this email in error, please notify the sender and delete 
this message and its attachments.
As emails may be altered, Orange is not liable for messages that have been 
modified, changed or falsified.
Thank you.
_______________________________________________
netmod mailing list -- [email protected]
To unsubscribe send an email to [email protected]

Reply via email to