[yang-doctors] Yangdoctors last call review of draft-ietf-rift-yang-03

[Michal Vaško via Datatracker <[e-mail]>]

Reviewer: Michal Vaško
Review result: Almost Ready

Generally, use references where make sense (features, nodes) and use units
and/or standard types (ietf-yang-types) for leaves (such as grouping
neighbor-node/bandwidth). All links are invalid, better to use references
anyway because the module will be used outside the RFC.

Specific problems:

- description - copyright 2020
- typedef ieee802-1as-timestamp-type - reference in description, put separately
- grouping address-families
        - list with a single key can be leaf-list
        - would make sense if meant to be augmented with new nodes
- grouping node-flag
        - used only once, makes sense if meant to be reused by other modules
        - consider using bits type in the leaf
- grouping base-node-info/pod - redundant description, use union of number and
"undefined", or leave out for undefined since it is not mandatory - augment
rift/rx-lie-multicast-address,tx-lie-multicast-address
        - default value in description - should be defined in YANG
                                                              - consider using
                                                              refine on
                                                              "addresses"
        rx-flood-port - redundant default in description, is obvious in YANG
        algorithm-type - empty cases - redundant on their own, are expected to
        be augmented? HAL - use lowercase
        database/tie/negative_disaggregation_prefixes
                - use hyphen instead of underscore
                - consider abbreviated/shorter node names
                - applicable for the following nodes as well