Skip to main content

A Common YANG Data Model for Scheduling
draft-ietf-netmod-schedule-yang-10

Revision differences

Document history

Date Rev. By Action
2025-09-04
10 (System) RFC Editor state changed to EDIT from AUTH
2025-08-29
10 Tero Kivinen Closed request for IETF Last Call review by SECDIR with state 'Overtaken by Events'
2025-08-29
10 Tero Kivinen Assignment of request for IETF Last Call review by SECDIR to Ned Smith was marked no-response
2025-08-26
10 (System) RFC Editor state changed to AUTH from EDIT
2025-08-26
10 (System) RFC Editor state changed to EDIT
2025-08-26
10 (System) IESG state changed to RFC Ed Queue from Approved-announcement sent
2025-08-26
10 (System) Announcement was received by RFC Editor
2025-08-22
10 (System) Removed all action holders (IESG state changed)
2025-08-22
10 Morgan Condie IESG state changed to Approved-announcement sent from Approved-announcement to be sent
2025-08-22
10 Morgan Condie IESG has approved the document
2025-08-22
10 Morgan Condie Closed "Approve" ballot
2025-08-22
10 Morgan Condie Ballot approval text was generated
2025-08-22
10 Mahesh Jethanandani IESG state changed to Approved-announcement to be sent from Approved-announcement to be sent::AD Followup
2025-08-09
10 Acee Lindem Request for Telechat review by RTGDIR Completed: Ready. Reviewer: Acee Lindem. Review has been revised by Acee Lindem.
2025-08-07
10 Cindy Morgan IESG state changed to Approved-announcement to be sent::AD Followup from IESG Evaluation
2025-08-07
10 (System) IANA Review state changed to Version Changed - Review Needed from IANA OK - Actions Needed
2025-08-07
10 Mohamed Boucadair New version available: draft-ietf-netmod-schedule-yang-10.txt
2025-08-07
10 Mohamed Boucadair New version approved
2025-08-07
10 (System) Request for posting confirmation emailed to previous authors: Daniel King , Mohamed Boucadair , Qin WU , Qiufang Ma
2025-08-07
10 Mohamed Boucadair Uploaded new revision
2025-08-06
09 Paul Wouters [Ballot Position Update] New position, No Objection, has been recorded for Paul Wouters
2025-08-06
09 Orie Steele [Ballot Position Update] New position, No Objection, has been recorded for Orie Steele
2025-08-05
09 Amanda Baber IANA Review state changed to IANA OK - Actions Needed from Version Changed - Review Needed
2025-08-05
09 Erik Kline [Ballot comment]
Thanks for addressing my comment!
2025-08-05
09 Erik Kline [Ballot Position Update] Position for Erik Kline has been changed to No Objection from Discuss
2025-08-05
09 Mike Bishop
[Ballot comment]
How will new values of schedule-type be defined? What should a client do if it encounters an unknown value? The text implies that …
[Ballot comment]
How will new values of schedule-type be defined? What should a client do if it encounters an unknown value? The text implies that there could be more defined in the future, but describes no forward-compatible handling.

In 3.3.4, it's fine to say that this document doesn't prohibit intervals shorter than durations; should this have a note similar to 3.3.3 recommending that users add restrictions if they require that recurrences not overlap?

Several comments in 3.3.4 seem like they apply equally to subsequent sections; a reference to those comments would be useful if they're not going to be repeated, or move them to apply more broadly.

In 3.3.9, is "bumped" a formally defined YANG term? Would "incremented" be better?

With regard to the leap second discussion, shouldn't it be sufficient to specify that :60 is a valid value that MUST be tolerated on receipt and MAY be produced if the implementation represents leap seconds that way?

=== NITS FOLLOW ===

- Abstract, "recurrence related" => "recurrence-related"

- 3.1, "iCalender like" => "iCalendar-like" or "like iCalendar"

- 3.3.2, "no later the end" => "no later than the end"
2025-08-05
09 Mike Bishop Ballot comment text updated for Mike Bishop
2025-08-05
09 Mike Bishop
[Ballot comment]
How will new values of schedule-type be defined? What should a client do if it encounters an unknown value? The text implies that …
[Ballot comment]
How will new values of schedule-type be defined? What should a client do if it encounters an unknown value? The text implies that there could be more defined in the future, but describes no forward-compatible handling.

In 3.3.4, it's fine to say that this document doesn't prohibit intervals shorter than durations; should this have a note similar to 3.3.3 recommending that users add restrictions if they require that recurrences not overlap?

Several comments in 3.3.4 seem like they apply equally to subsequent sections; a reference to those comments would be useful if they're not going to be repeated, or move them to apply more broadly.

In 3.3.9, is "bumped" a formally defined YANG term? Would "incremented" be better?

With regard to the leap second discussion, shouldn't it be sufficient to specify that :60 is a valid value that MUST be tolerated on receipt and MAY be produced if the implementation represents leap seconds that way?

=== NITS FOLLOW ===

- Abstract, "recurrence related" => "recurrence-related"

- 3.1, "iCalender like" => "iCalender-like" or "like iCalender"

- 3.3.2, "no later the end" => "no later than the end"
2025-08-05
09 Mike Bishop [Ballot Position Update] New position, No Objection, has been recorded for Mike Bishop
2025-08-05
09 Andy Newton [Ballot Position Update] New position, No Objection, has been recorded for Andy Newton
2025-08-05
09 Gunter Van de Velde [Ballot comment]
Many thanks to Acee for his RTG DIR review, and to the authors to consider the comments.
2025-08-05
09 Gunter Van de Velde [Ballot Position Update] New position, No Objection, has been recorded for Gunter Van de Velde
2025-08-04
09 Mohamed Boucadair New version available: draft-ietf-netmod-schedule-yang-09.txt
2025-08-04
09 Mohamed Boucadair New version approved
2025-08-04
09 (System) Request for posting confirmation emailed to previous authors: Daniel King , Mohamed Boucadair , Qin WU , Qiufang Ma
2025-08-04
09 Mohamed Boucadair Uploaded new revision
2025-08-03
08 Erik Kline
[Ballot discuss]
# Internet AD comments for draft-ietf-netmod-schedule-yang-08
CC @ekline

* comment syntax:
  - https://github.com/mnot/ietf-comments/blob/main/format.md

* "Handling Ballot Positions":
  - https://ietf.org/about/groups/iesg/statements/handling-ballot-positions/

## Discuss …
[Ballot discuss]
# Internet AD comments for draft-ietf-netmod-schedule-yang-08
CC @ekline

* comment syntax:
  - https://github.com/mnot/ietf-comments/blob/main/format.md

* "Handling Ballot Positions":
  - https://ietf.org/about/groups/iesg/statements/handling-ballot-positions/

## Discuss

### S4

*  "The second for date and time values MUST have the value "60" at
    the end of months in which a leap second occurs."

  I think this ties too strongly to an outmoded way of handling leap
  seconds.  It is widely documented by some cloud operators, for example,
  that "leap smearing" can be employed [1, 2].  A scheduler taking time
  from a leap smeared clock would never encode "60" at any time, nor
  should it.

  I think you can retain this MUST if you craft an exemption for schedule
  producers and consumers that have no other way of dealing with leap
  seconds.

  (Separately, I've taken a note to see about crafting some draft that
    might be a useful reference.)

  [1] https://developers.google.com/time/smear
  [2] https://aws.amazon.com/blogs/aws/look-before-you-leap-the-coming-leap-second-and-aws/
2025-08-03
08 Erik Kline [Ballot Position Update] New position, Discuss, has been recorded for Erik Kline
2025-08-02
08 Acee Lindem Request for Telechat review by RTGDIR Completed: Not Ready. Reviewer: Acee Lindem.
2025-08-01
08 Ran Chen Request for Telechat review by RTGDIR is assigned to Acee Lindem
2025-07-30
08 Roman Danyliw [Ballot comment]
Thank you to Peter Yee for the GENART review.
2025-07-30
08 Roman Danyliw [Ballot Position Update] New position, No Objection, has been recorded for Roman Danyliw
2025-07-30
08 Ketan Talaulikar Requested Telechat review by RTGDIR
2025-07-29
08 Éric Vyncke
[Ballot comment]

# Éric Vyncke, INT AD, comments for draft-ietf-netmod-schedule-yang-08
CC @evyncke

Thank you for the work put into this document.

Please find below some …
[Ballot comment]

# Éric Vyncke, INT AD, comments for draft-ietf-netmod-schedule-yang-08
CC @evyncke

Thank you for the work put into this document.

Please find below some non-blocking COMMENT points/nits (replies would be appreciated even if only for my own education).

Special thanks to James Cumming for the shepherd's write-up including the WG consensus *but it lacks* the justification of the intended status.

I hope that this review helps to improve the document,

Regards,

-éric

## COMMENTS (non-blocking)

### Compliant with NMDA ?

AFAIK, RFC 8407 section 3.5 recommends stating in the introduction whether the YANG module complies with NMDA (RFC 8342). As draft-ietf-netmod-rfc8407bis is not yet approved, it seems to me that the previous guidance should be followed.

### WGLC extended to calendaring WG

The shepherd write-up says nothing about the potential extension of the WGLC to calendaring-related WG such as CALEXT or to the calsify@ietf.org mailing list.
2025-07-29
08 Éric Vyncke [Ballot Position Update] New position, No Objection, has been recorded for Éric Vyncke
2025-07-29
08 Jim Guichard [Ballot Position Update] New position, No Objection, has been recorded for Jim Guichard
2025-07-28
08 Deb Cooley [Ballot Position Update] New position, No Objection, has been recorded for Deb Cooley
2025-07-05
08 Peter Yee
Request for IETF Last Call review by GENART Completed: Ready with Nits. Reviewer: Peter Yee. Sent review to list. Submission of review completed at an …
Request for IETF Last Call review by GENART Completed: Ready with Nits. Reviewer: Peter Yee. Sent review to list. Submission of review completed at an earlier date.
2025-07-05
08 Peter Yee Request for IETF Last Call review by GENART Completed: Ready with Nits. Reviewer: Peter Yee.
2025-07-04
08 (System) IANA Review state changed to Version Changed - Review Needed from IANA OK - Actions Needed
2025-07-04
08 Mohamed Boucadair New version available: draft-ietf-netmod-schedule-yang-08.txt
2025-07-04
08 Mohamed Boucadair New version approved
2025-07-04
08 (System) Request for posting confirmation emailed to previous authors: Daniel King , Mohamed Boucadair , Qin WU , Qiufang Ma
2025-07-04
08 Mohamed Boucadair Uploaded new revision
2025-07-02
07 Mohamed Boucadair [Ballot comment]
As I'm an author.
2025-07-02
07 Mohamed Boucadair [Ballot Position Update] New position, Recuse, has been recorded for Mohamed Boucadair
2025-07-01
07 Morgan Condie Placed on agenda for telechat - 2025-08-07
2025-07-01
07 Mahesh Jethanandani Ballot has been issued
2025-07-01
07 Mahesh Jethanandani [Ballot Position Update] New position, Yes, has been recorded for Mahesh Jethanandani
2025-07-01
07 Mahesh Jethanandani Created "Approve" ballot
2025-07-01
07 Mahesh Jethanandani IESG state changed to IESG Evaluation from Waiting for AD Go-Ahead
2025-07-01
07 Mahesh Jethanandani Ballot writeup was changed
2025-06-27
07 Per Andersson Request for IETF Last Call review by OPSDIR Completed: Has Nits. Reviewer: Per Andersson. Sent review to list.
2025-06-27
07 (System) IESG state changed to Waiting for AD Go-Ahead from In Last Call
2025-06-23
07 David Dong
IESG/Authors/WG Chairs:

IANA has completed its review of draft-ietf-netmod-schedule-yang-07. If any part of this review is inaccurate, please let us know.

IANA understands that, upon …
IESG/Authors/WG Chairs:

IANA has completed its review of draft-ietf-netmod-schedule-yang-07. If any part of this review is inaccurate, please let us know.

IANA understands that, upon approval of this document, there are two actions which we must complete.

First, in the ns registry on the IETF XML Registry group located at:

https://www.iana.org/assignments/xml-registry/

a single new namespace will be registered as follows:

ID: yang:ietf-schedule
URI: urn:ietf:params:xml:ns:yang:ietf-schedule
Filename: [ TBD-at-Registration ]
Reference: [ RFC-to-be ]

As this document requests a registration in an Expert Review or Specification Required (see RFC 8126) registry, we have completed the required Expert Review via a separate request.

Second, in the YANG Module Names registry on the YANG Parameters registry group located at:

https://www.iana.org/assignments/yang-parameters/

a single, new YANG module will be registered as follows:

Name: ietf-schedule
File: [ TBD-at-Registration ]
Maintained by IANA? N
Namespace: urn:ietf:params:xml:ns:yang:ietf-schedule
Prefix: schedule
Module:
Reference: [ RFC-to-be ]

While the YANG module name will be registered after the IESG approves the document, the YANG module file will be posted after the RFC Editor notifies us that the document has been published.

We understand that these are the only actions required to be completed upon approval of this document.

NOTE: The actions requested in this document will not be completed until the document has been approved for publication as an RFC. This message is meant only to confirm the list of actions that will be performed.

For definitions of IANA review states, please see:

https://datatracker.ietf.org/help/state/draft/iana-review

Thank you,

David Dong
IANA Services Sr. Specialist
2025-06-23
07 (System) IANA Review state changed to IANA OK - Actions Needed from IANA - Review Needed
2025-06-21
07 Tero Kivinen Request for IETF Last Call review by SECDIR is assigned to Ned Smith
2025-06-17
07 Bo Wu Request for IETF Last Call review by OPSDIR is assigned to Per Andersson
2025-06-17
07 David Dong IANA Experts State changed to Expert Reviews OK from Reviews assigned
2025-06-16
07 David Dong IANA Experts State changed to Reviews assigned
2025-06-16
07 Jean Mahoney Request for IETF Last Call review by GENART is assigned to Peter Yee
2025-06-14
07 Barry Leiba Closed request for IETF Last Call review by ARTART with state 'Team Will not Review Document'
2025-06-13
07 Morgan Condie IANA Review state changed to IANA - Review Needed
2025-06-13
07 Morgan Condie
The following Last Call announcement was sent out (ends 2025-06-27):

From: The IESG
To: IETF-Announce
CC: draft-ietf-netmod-schedule-yang@ietf.org, james.cumming@nokia.com, mjethanandani@gmail.com, netmod-chairs@ietf.org, netmod@ietf.org …
The following Last Call announcement was sent out (ends 2025-06-27):

From: The IESG
To: IETF-Announce
CC: draft-ietf-netmod-schedule-yang@ietf.org, james.cumming@nokia.com, mjethanandani@gmail.com, netmod-chairs@ietf.org, netmod@ietf.org
Reply-To: last-call@ietf.org
Sender:
Subject: Last Call:  (A Common YANG Data Model for Scheduling) to Proposed Standard


The IESG has received a request from the Network Modeling WG (netmod) to
consider the following document: - 'A Common YANG Data Model for Scheduling'
  as Proposed Standard

The IESG plans to make a decision in the next few weeks, and solicits final
comments on this action. Please send substantive comments to the
last-call@ietf.org mailing lists by 2025-06-27. Exceptionally, comments may
be sent to iesg@ietf.org instead. In either case, please retain the beginning
of the Subject line to allow automated sorting.

Abstract


  This document defines common types and groupings that are meant to be
  used for scheduling purposes such as event, policy, services, or
  resources based on date and time.  For the sake of better modularity,
  the YANG module includes a set of recurrence related groupings with
  varying levels of representation (i.e., from basic to advanced) to
  accommodate a variety of requirements.  It also defines groupings for
  validating requested schedules and reporting scheduling status.




The file can be obtained via
https://datatracker.ietf.org/doc/draft-ietf-netmod-schedule-yang/



No IPR declarations have been submitted directly on this I-D.




2025-06-13
07 Morgan Condie IESG state changed to In Last Call from Last Call Requested
2025-06-13
07 Mahesh Jethanandani Requested IETF Last Call review by ARTART
2025-06-13
07 Mahesh Jethanandani Requested IETF Last Call review by OPSDIR
2025-06-13
07 Mahesh Jethanandani Requested IETF Last Call review by GENART
2025-06-13
07 Mahesh Jethanandani Last call was requested
2025-06-13
07 Mahesh Jethanandani Last call announcement was generated
2025-06-13
07 Mahesh Jethanandani Ballot approval text was generated
2025-06-13
07 Mahesh Jethanandani Ballot writeup was generated
2025-06-13
07 Mahesh Jethanandani IESG state changed to Last Call Requested from AD Evaluation::AD Followup
2025-06-12
07 (System) Changed action holders to Mahesh Jethanandani (IESG state changed)
2025-06-12
07 (System) Sub state has been changed to AD Followup from Revised I-D Needed
2025-06-12
07 Mohamed Boucadair New version available: draft-ietf-netmod-schedule-yang-07.txt
2025-06-12
07 Mohamed Boucadair New version approved
2025-06-12
07 (System) Request for posting confirmation emailed to previous authors: Daniel King , Mohamed Boucadair , Qin WU , Qiufang Ma
2025-06-12
07 Mohamed Boucadair Uploaded new revision
2025-06-01
06 Mahesh Jethanandani Please see my additional comments at: https://mailarchive.ietf.org/arch/msg/netmod/V5SDL1zJX8oTXeRAUaRvT6F1Oy8/
2025-06-01
06 (System) Changed action holders to Daniel King, Qin Wu, Mohamed Boucadair, Qiufang Ma (IESG state changed)
2025-06-01
06 Mahesh Jethanandani IESG state changed to AD Evaluation::Revised I-D Needed from AD Evaluation::AD Followup
2025-05-29
06 (System) Changed action holders to Mahesh Jethanandani (IESG state changed)
2025-05-29
06 (System) Sub state has been changed to AD Followup from Revised I-D Needed
2025-05-29
06 Qiufang Ma New version available: draft-ietf-netmod-schedule-yang-06.txt
2025-05-29
06 Qiufang Ma New version approved
2025-05-29
06 (System) Request for posting confirmation emailed to previous authors: Daniel King , Mohamed Boucadair , Qin WU , Qiufang Ma
2025-05-29
06 Qiufang Ma Uploaded new revision
2025-05-16
05 Mahesh Jethanandani The AD review can be found here - https://mailarchive.ietf.org/arch/msg/netmod/eC9SEDOxuY8vaQRTHIdCzCtyf6k/
2025-05-16
05 (System) Changed action holders to Mahesh Jethanandani, Daniel King, Qin Wu, Mohamed Boucadair, Qiufang Ma (IESG state changed)
2025-05-16
05 Mahesh Jethanandani IESG state changed to AD Evaluation::Revised I-D Needed from Publication Requested
2025-04-28
05 James Cumming
# Document Shepherd Write-Up for draft-ietf-netmod-schedule-yang-05


## Document History

1. Does the working group (WG) consensus represent the strong concurrence of a
  few individuals, …
# Document Shepherd Write-Up for draft-ietf-netmod-schedule-yang-05


## Document History

1. Does the working group (WG) consensus represent the strong concurrence of a
  few individuals, with others being silent, or did it reach broad agreement?
 
  The document has working group consensus, however, contributions have been driven by a small number of individuals.
 
2. Was there controversy about particular points, or were there decisions where
  the consensus was particularly rough?
 
  No

3. Has anyone threatened an appeal or otherwise indicated extreme discontent? If
  so, please summarize the areas of conflict in separate email messages to the
  responsible Area Director. (It should be in a separate email because this
  questionnaire is publicly available.)
 
  No

4. For protocol documents, are there existing implementations of the contents of
  the document? Have a significant number of potential implementers indicated
  plans to implement? Are any existing implementations reported somewhere,
  either in the document itself (as [RFC 7942][3] recommends) or elsewhere
  (where)?
 
  N/A

## Additional Reviews

5. Do the contents of this document closely interact with technologies in other
  IETF working groups or external organizations, and would it therefore benefit
  from their review? Have those reviews occurred? If yes, describe which
  reviews took place.
 
  The module defines groupings that may be used in other areas but does not directly impact work in other areas.

6. Describe how the document meets any required formal expert review criteria,
  such as the MIB Doctor, YANG Doctor, media type, and URI type reviews.
 
  Multiple YANG doctor reviews have taken place.  The authors have incorporated the majority of the feedback.  The only outstanding feedback from the YANG doctor is that the reviewer felt that not defining a default statement in the YANG, whilst refering to a default value in the description of the same statement was confusing.  The authors believe that this providing guideance to implementors where an explicit default statement might be incorrect for a YANG groupings draft and therefore believe that this guideance text should remain.  The working group was consulted on the list and provided no objections.

7. If the document contains a YANG module, has the final version of the module
  been checked with any of the [recommended validation tools][4] for syntax and
  formatting validation? If there are any resulting errors or warnings, what is
  the justification for not fixing them at this time? Does the YANG module
  comply with the Network Management Datastore Architecture (NMDA) as specified
  in [RFC 8342][5]?
 
  Checked with no issues.

8. Describe reviews and automated checks performed to validate sections of the
  final version of the document written in a formal language, such as XML code,
  BNF rules, MIB definitions, CBOR's CDDL, etc.
 
XML checked with xmllint


## Document Shepherd Checks

9. Based on the shepherd's review of the document, is it their opinion that this
  document is needed, clearly written, complete, correctly designed, and ready
  to be handed off to the responsible Area Director?
 
  Yes

10. Several IETF Areas have assembled [lists of common issues that their
    reviewers encounter][6]. For which areas have such issues been identified
    and addressed? For which does this still need to happen in subsequent
    reviews?
   
    The specific area here is the security considerations section, which accurately reflects the narrow impact this draft has as it is defining YANG groupings.

11. What type of RFC publication is being requested on the IETF stream ([Best
    Current Practice][12], [Proposed Standard, Internet Standard][13],
    [Informational, Experimental or Historic][14])? Why is this the proper type
    of RFC? Do all Datatracker state attributes correctly reflect this intent?
   
    Proposed Standard reflected in datatracker

12. Have reasonable efforts been made to remind all authors of the intellectual
    property rights (IPR) disclosure obligations described in [BCP 79][7]? To
    the best of your knowledge, have all required disclosures been filed? If
    not, explain why. If yes, summarize any relevant discussion, including links
    to publicly-available messages when applicable.
   
    WG last call IPR call completed.  All authors and contributors responded with no IPR disclosures raised.  https://mailarchive.ietf.org/arch/browse/netmod/?q=WG%20Last%20Call%20-%20A%20Common%20YANG%20Data%20Model%20for%20Scheduling&gbt=1&index= 

13. Has each author, editor, and contributor shown their willingness to be
    listed as such? If the total number of authors and editors on the front page
    is greater than five, please provide a justification.
   
    Yes. Less than 5 authors.

14. Document any remaining I-D nits in this document. Simply running the [idnits
    tool][8] is not enough; please review the ["Content Guidelines" on
    authors.ietf.org][15]. (Also note that the current idnits tool generates
    some incorrect warnings; a rewrite is underway.)
 
    Checked and confirmed with authors that the remaining NITS are harmless/incorrect warnings based on tooling issues.
 
15. Should any informative references be normative or vice-versa? See the [IESG
    Statement on Normative and Informative References][16].
   
    No. Referenced correctly.

16. List any normative references that are not freely available to anyone. Did
    the community have sufficient access to review any such normative
    references?
   
    N/A

17. Are there any normative downward references (see [RFC 3967][9] and [BCP
    97
][10]) that are not already listed in the [DOWNREF registry][17]? If so,
    list them.
   
    N/A

18. Are there normative references to documents that are not ready to be
    submitted to the IESG for publication or are otherwise in an unclear state?
    If so, what is the plan for their completion?
   
    N/A

19. Will publication of this document change the status of any existing RFCs? If
    so, does the Datatracker metadata correctly reflect this and are those RFCs
    listed on the title page, in the abstract, and discussed in the
    introduction? If not, explain why and point to the part of the document
    where the relationship of this document to these other RFCs is discussed.
   
    No

20. Describe the document shepherd's review of the IANA considerations section,
    especially with regard to its consistency with the body of the document.
    Confirm that all aspects of the document requiring IANA assignments are
    associated with the appropriate reservations in IANA registries. Confirm
    that any referenced IANA registries have been clearly identified. Confirm
    that each newly created IANA registry specifies its initial contents,
    allocations procedures, and a reasonable name (see [RFC 8126][11]).
   
    The IANA section correctly identifies the two IANA registries that need allocations/entries to be updated.

21. List any new IANA registries that require Designated Expert Review for
    future allocations. Are the instructions to the Designated Expert clear?
    Please include suggestions of designated experts, if appropriate.
   
    N/A
   

[1]: https://www.ietf.org/about/groups/iesg/
[2]: https://www.rfc-editor.org/rfc/rfc4858.html
[3]: https://www.rfc-editor.org/rfc/rfc7942.html
[4]: https://wiki.ietf.org/group/ops/yang-review-tools
[5]: https://www.rfc-editor.org/rfc/rfc8342.html
[6]: https://wiki.ietf.org/group/iesg/ExpertTopics
[7]: https://www.rfc-editor.org/info/bcp79
[8]: https://www.ietf.org/tools/idnits/
[9]: https://www.rfc-editor.org/rfc/rfc3967.html
[10]: https://www.rfc-editor.org/info/bcp97
[11]: https://www.rfc-editor.org/rfc/rfc8126.html
[12]: https://www.rfc-editor.org/rfc/rfc2026.html#section-5
[13]: https://www.rfc-editor.org/rfc/rfc2026.html#section-4.1
[14]: https://www.rfc-editor.org/rfc/rfc2026.html#section-4.2
[15]: https://authors.ietf.org/en/content-guidelines-overview
[16]: https://www.ietf.org/about/groups/iesg/statements/normative-informative-references/
[17]: https://datatracker.ietf.org/doc/downref/

2025-04-28
05 James Cumming
# Document Shepherd Write-Up for draft-ietf-netmod-schedule-yang-05


## Document History

1. Does the working group (WG) consensus represent the strong concurrence of a
  few individuals, …
# Document Shepherd Write-Up for draft-ietf-netmod-schedule-yang-05


## Document History

1. Does the working group (WG) consensus represent the strong concurrence of a
  few individuals, with others being silent, or did it reach broad agreement?
 
  The document has working group consensus, however, contributions have been driven by a small number of individuals.
 
2. Was there controversy about particular points, or were there decisions where
  the consensus was particularly rough?
 
  No

3. Has anyone threatened an appeal or otherwise indicated extreme discontent? If
  so, please summarize the areas of conflict in separate email messages to the
  responsible Area Director. (It should be in a separate email because this
  questionnaire is publicly available.)
 
  No

4. For protocol documents, are there existing implementations of the contents of
  the document? Have a significant number of potential implementers indicated
  plans to implement? Are any existing implementations reported somewhere,
  either in the document itself (as [RFC 7942][3] recommends) or elsewhere
  (where)?
 
  N/A

## Additional Reviews

5. Do the contents of this document closely interact with technologies in other
  IETF working groups or external organizations, and would it therefore benefit
  from their review? Have those reviews occurred? If yes, describe which
  reviews took place.
 
  The module defines groupings that may be used in other areas but does not directly impact work in other areas.

6. Describe how the document meets any required formal expert review criteria,
  such as the MIB Doctor, YANG Doctor, media type, and URI type reviews.
 
  Multiple YANG doctor reviews have taken place.  The authors have incorporated the majority of the feedback.  The only outstanding feedback from the YANG doctor is that the reviewer felt that not defining a default statement in the YANG, whilst refering to a default value in the description of the same statement was confusing.  The authors believe that this providing guideance to implementors where an explicit default statement might be incorrect for a YANG groupings draft and therefore believe that this guideance text should remain.  The working group was consulted on the list and provided no objections.

7. If the document contains a YANG module, has the final version of the module
  been checked with any of the [recommended validation tools][4] for syntax and
  formatting validation? If there are any resulting errors or warnings, what is
  the justification for not fixing them at this time? Does the YANG module
  comply with the Network Management Datastore Architecture (NMDA) as specified
  in [RFC 8342][5]?
 
  Checked with no issues.

8. Describe reviews and automated checks performed to validate sections of the
  final version of the document written in a formal language, such as XML code,
  BNF rules, MIB definitions, CBOR's CDDL, etc.
 
XML checked with xmllint


## Document Shepherd Checks

9. Based on the shepherd's review of the document, is it their opinion that this
  document is needed, clearly written, complete, correctly designed, and ready
  to be handed off to the responsible Area Director?
 
  Yes

10. Several IETF Areas have assembled [lists of common issues that their
    reviewers encounter][6]. For which areas have such issues been identified
    and addressed? For which does this still need to happen in subsequent
    reviews?
   
    The specific area here is the security considerations section, which accurately reflects the narrow impact this draft has as it is defining YANG groupings.

11. What type of RFC publication is being requested on the IETF stream ([Best
    Current Practice][12], [Proposed Standard, Internet Standard][13],
    [Informational, Experimental or Historic][14])? Why is this the proper type
    of RFC? Do all Datatracker state attributes correctly reflect this intent?
   
    Proposed Standard reflected in datatracker

12. Have reasonable efforts been made to remind all authors of the intellectual
    property rights (IPR) disclosure obligations described in [BCP 79][7]? To
    the best of your knowledge, have all required disclosures been filed? If
    not, explain why. If yes, summarize any relevant discussion, including links
    to publicly-available messages when applicable.
   
    WG last call IPR call completed.  All authors and contributors responded with negative IPR responses.  https://mailarchive.ietf.org/arch/browse/netmod/?q=WG%20Last%20Call%20-%20A%20Common%20YANG%20Data%20Model%20for%20Scheduling&gbt=1&index= 

13. Has each author, editor, and contributor shown their willingness to be
    listed as such? If the total number of authors and editors on the front page
    is greater than five, please provide a justification.
   
    Yes. Less than 5 authors.

14. Document any remaining I-D nits in this document. Simply running the [idnits
    tool][8] is not enough; please review the ["Content Guidelines" on
    authors.ietf.org][15]. (Also note that the current idnits tool generates
    some incorrect warnings; a rewrite is underway.)
 
    Checked and confirmed with authors that the remaining NITS are harmless/incorrect warnings based on tooling issues.
 
15. Should any informative references be normative or vice-versa? See the [IESG
    Statement on Normative and Informative References][16].
   
    No. Referenced correctly.

16. List any normative references that are not freely available to anyone. Did
    the community have sufficient access to review any such normative
    references?
   
    N/A

17. Are there any normative downward references (see [RFC 3967][9] and [BCP
    97
][10]) that are not already listed in the [DOWNREF registry][17]? If so,
    list them.
   
    N/A

18. Are there normative references to documents that are not ready to be
    submitted to the IESG for publication or are otherwise in an unclear state?
    If so, what is the plan for their completion?
   
    N/A

19. Will publication of this document change the status of any existing RFCs? If
    so, does the Datatracker metadata correctly reflect this and are those RFCs
    listed on the title page, in the abstract, and discussed in the
    introduction? If not, explain why and point to the part of the document
    where the relationship of this document to these other RFCs is discussed.
   
    No

20. Describe the document shepherd's review of the IANA considerations section,
    especially with regard to its consistency with the body of the document.
    Confirm that all aspects of the document requiring IANA assignments are
    associated with the appropriate reservations in IANA registries. Confirm
    that any referenced IANA registries have been clearly identified. Confirm
    that each newly created IANA registry specifies its initial contents,
    allocations procedures, and a reasonable name (see [RFC 8126][11]).
   
    The IANA section correctly identifies the two IANA registries that need allocations/entries to be updated.

21. List any new IANA registries that require Designated Expert Review for
    future allocations. Are the instructions to the Designated Expert clear?
    Please include suggestions of designated experts, if appropriate.
   
    N/A
   

[1]: https://www.ietf.org/about/groups/iesg/
[2]: https://www.rfc-editor.org/rfc/rfc4858.html
[3]: https://www.rfc-editor.org/rfc/rfc7942.html
[4]: https://wiki.ietf.org/group/ops/yang-review-tools
[5]: https://www.rfc-editor.org/rfc/rfc8342.html
[6]: https://wiki.ietf.org/group/iesg/ExpertTopics
[7]: https://www.rfc-editor.org/info/bcp79
[8]: https://www.ietf.org/tools/idnits/
[9]: https://www.rfc-editor.org/rfc/rfc3967.html
[10]: https://www.rfc-editor.org/info/bcp97
[11]: https://www.rfc-editor.org/rfc/rfc8126.html
[12]: https://www.rfc-editor.org/rfc/rfc2026.html#section-5
[13]: https://www.rfc-editor.org/rfc/rfc2026.html#section-4.1
[14]: https://www.rfc-editor.org/rfc/rfc2026.html#section-4.2
[15]: https://authors.ietf.org/en/content-guidelines-overview
[16]: https://www.ietf.org/about/groups/iesg/statements/normative-informative-references/
[17]: https://datatracker.ietf.org/doc/downref/

2025-04-28
05 James Cumming IETF WG state changed to Submitted to IESG for Publication from In WG Last Call
2025-04-28
05 James Cumming IESG state changed to Publication Requested from I-D Exists
2025-04-28
05 (System) Changed action holders to Mahesh Jethanandani (IESG state changed)
2025-04-28
05 James Cumming Responsible AD changed to Mahesh Jethanandani
2025-04-28
05 James Cumming Document is now in IESG state Publication Requested
2025-03-18
05 James Cumming
# Document Shepherd Write-Up for draft-ietf-netmod-schedule-yang-05


## Document History

1. Does the working group (WG) consensus represent the strong concurrence of a
  few individuals, …
# Document Shepherd Write-Up for draft-ietf-netmod-schedule-yang-05


## Document History

1. Does the working group (WG) consensus represent the strong concurrence of a
  few individuals, with others being silent, or did it reach broad agreement?
 
  The document has working group consensus, however, contributions have been driven by a small number of individuals.
 
2. Was there controversy about particular points, or were there decisions where
  the consensus was particularly rough?
 
  No

3. Has anyone threatened an appeal or otherwise indicated extreme discontent? If
  so, please summarize the areas of conflict in separate email messages to the
  responsible Area Director. (It should be in a separate email because this
  questionnaire is publicly available.)
 
  No

4. For protocol documents, are there existing implementations of the contents of
  the document? Have a significant number of potential implementers indicated
  plans to implement? Are any existing implementations reported somewhere,
  either in the document itself (as [RFC 7942][3] recommends) or elsewhere
  (where)?
 
  N/A

## Additional Reviews

5. Do the contents of this document closely interact with technologies in other
  IETF working groups or external organizations, and would it therefore benefit
  from their review? Have those reviews occurred? If yes, describe which
  reviews took place.
 
  The module defines groupings that may be used in other areas but does not directly impact work in other areas.

6. Describe how the document meets any required formal expert review criteria,
  such as the MIB Doctor, YANG Doctor, media type, and URI type reviews.
 
  Multiple YANG doctor reviews have taken place.  The authors have incorporated the majority of the feedback.  The only outstanding feedback from the YANG doctor is that the reviewer felt that not defining a default statement in the YANG, whilst refering to a default value in the description of the same statement was confusing.  The authors believe that this providing guideance to implementors where an explicit default statement might be incorrect for a YANG groupings draft and therefore believe that this guideance text should remain.  The working group was consulted on the list and provided no objections.

7. If the document contains a YANG module, has the final version of the module
  been checked with any of the [recommended validation tools][4] for syntax and
  formatting validation? If there are any resulting errors or warnings, what is
  the justification for not fixing them at this time? Does the YANG module
  comply with the Network Management Datastore Architecture (NMDA) as specified
  in [RFC 8342][5]?
 
  Checked with no issues.

8. Describe reviews and automated checks performed to validate sections of the
  final version of the document written in a formal language, such as XML code,
  BNF rules, MIB definitions, CBOR's CDDL, etc.
 
XML checked with xmllint


## Document Shepherd Checks

9. Based on the shepherd's review of the document, is it their opinion that this
  document is needed, clearly written, complete, correctly designed, and ready
  to be handed off to the responsible Area Director?
 
  Yes

10. Several IETF Areas have assembled [lists of common issues that their
    reviewers encounter][6]. For which areas have such issues been identified
    and addressed? For which does this still need to happen in subsequent
    reviews?
   
    The specific area here is the security considerations section, which accurately reflects the narrow impact this draft has as it is defining YANG groupings.

11. What type of RFC publication is being requested on the IETF stream ([Best
    Current Practice][12], [Proposed Standard, Internet Standard][13],
    [Informational, Experimental or Historic][14])? Why is this the proper type
    of RFC? Do all Datatracker state attributes correctly reflect this intent?
   
    Proposed Standard reflected in datatracker

12. Have reasonable efforts been made to remind all authors of the intellectual
    property rights (IPR) disclosure obligations described in [BCP 79][7]? To
    the best of your knowledge, have all required disclosures been filed? If
    not, explain why. If yes, summarize any relevant discussion, including links
    to publicly-available messages when applicable.
   
    WG last call IPR call completed.  All authors and contributors responded with negative IPR responses.  https://mailarchive.ietf.org/arch/browse/netmod/?q=WG%20Last%20Call%20-%20A%20Common%20YANG%20Data%20Model%20for%20Scheduling&gbt=1&index= 

13. Has each author, editor, and contributor shown their willingness to be
    listed as such? If the total number of authors and editors on the front page
    is greater than five, please provide a justification.
   
    Yes. Less than 5 authors.

14. Document any remaining I-D nits in this document. Simply running the [idnits
    tool][8] is not enough; please review the ["Content Guidelines" on
    authors.ietf.org][15]. (Also note that the current idnits tool generates
    some incorrect warnings; a rewrite is underway.)
 
    Checked and confirmed with authors that the remaining NITS are harmless/incorrect warnings based on tooling issues.
 
15. Should any informative references be normative or vice-versa? See the [IESG
    Statement on Normative and Informative References][16].
   
    No. Referenced correctly.

16. List any normative references that are not freely available to anyone. Did
    the community have sufficient access to review any such normative
    references?
   
    N/A

17. Are there any normative downward references (see [RFC 3967][9] and [BCP
    97
][10]) that are not already listed in the [DOWNREF registry][17]? If so,
    list them.
   
    N/A

18. Are there normative references to documents that are not ready to be
    submitted to the IESG for publication or are otherwise in an unclear state?
    If so, what is the plan for their completion?
   
    N/A

19. Will publication of this document change the status of any existing RFCs? If
    so, does the Datatracker metadata correctly reflect this and are those RFCs
    listed on the title page, in the abstract, and discussed in the
    introduction? If not, explain why and point to the part of the document
    where the relationship of this document to these other RFCs is discussed.
   
    No

20. Describe the document shepherd's review of the IANA considerations section,
    especially with regard to its consistency with the body of the document.
    Confirm that all aspects of the document requiring IANA assignments are
    associated with the appropriate reservations in IANA registries. Confirm
    that any referenced IANA registries have been clearly identified. Confirm
    that each newly created IANA registry specifies its initial contents,
    allocations procedures, and a reasonable name (see [RFC 8126][11]).
   
    The IANA section correctly identifies the two IANA registries that need allocations/entries to be updated.

21. List any new IANA registries that require Designated Expert Review for
    future allocations. Are the instructions to the Designated Expert clear?
    Please include suggestions of designated experts, if appropriate.
   
    N/A
   

[1]: https://www.ietf.org/about/groups/iesg/
[2]: https://www.rfc-editor.org/rfc/rfc4858.html
[3]: https://www.rfc-editor.org/rfc/rfc7942.html
[4]: https://wiki.ietf.org/group/ops/yang-review-tools
[5]: https://www.rfc-editor.org/rfc/rfc8342.html
[6]: https://wiki.ietf.org/group/iesg/ExpertTopics
[7]: https://www.rfc-editor.org/info/bcp79
[8]: https://www.ietf.org/tools/idnits/
[9]: https://www.rfc-editor.org/rfc/rfc3967.html
[10]: https://www.rfc-editor.org/info/bcp97
[11]: https://www.rfc-editor.org/rfc/rfc8126.html
[12]: https://www.rfc-editor.org/rfc/rfc2026.html#section-5
[13]: https://www.rfc-editor.org/rfc/rfc2026.html#section-4.1
[14]: https://www.rfc-editor.org/rfc/rfc2026.html#section-4.2
[15]: https://authors.ietf.org/en/content-guidelines-overview
[16]: https://www.ietf.org/about/groups/iesg/statements/normative-informative-references/
[17]: https://datatracker.ietf.org/doc/downref/

2025-03-16
05 Qiufang Ma New version available: draft-ietf-netmod-schedule-yang-05.txt
2025-03-16
05 Qiufang Ma New version approved
2025-03-16
05 (System) Request for posting confirmation emailed to previous authors: Daniel King , Mohamed Boucadair , Qin WU , Qiufang Ma
2025-03-16
05 Qiufang Ma Uploaded new revision
2025-03-11
04 James Cumming Changed consensus to Yes from Unknown
2025-03-11
04 James Cumming Intended Status changed to Proposed Standard from None
2025-02-07
04 Mohamed Boucadair New version available: draft-ietf-netmod-schedule-yang-04.txt
2025-02-07
04 Qiufang Ma New version approved
2025-02-07
04 (System) Request for posting confirmation emailed to previous authors: Daniel King , Mohamed Boucadair , Qin WU , Qiufang Ma
2025-02-07
04 Mohamed Boucadair Uploaded new revision
2025-01-21
03 Reshad Rahman Request for Last Call review by YANGDOCTORS Completed: Ready with Issues. Reviewer: Reshad Rahman. Sent review to list.
2025-01-20
03 Mehmet Ersue Request for Last Call review by YANGDOCTORS is assigned to Reshad Rahman
2025-01-16
03 James Cumming IETF WG state changed to In WG Last Call from WG Document
2025-01-16
03 James Cumming Requested Last Call review by YANGDOCTORS
2024-12-02
03 Kent Watsen Notification list changed to james.cumming@nokia.com because the document shepherd was set
2024-12-02
03 Kent Watsen Document shepherd changed to James Cumming
2024-10-10
03 Mohamed Boucadair New version available: draft-ietf-netmod-schedule-yang-03.txt
2024-10-10
03 Mohamed Boucadair New version approved
2024-10-10
03 (System) Request for posting confirmation emailed to previous authors: Daniel King , Mohamed Boucadair , Qin WU , Qiufang Ma
2024-10-10
03 Mohamed Boucadair Uploaded new revision
2024-10-03
02 Reshad Rahman Request for Early review by YANGDOCTORS Completed: On the Right Track. Reviewer: Reshad Rahman. Review has been revised by Reshad Rahman.
2024-10-03
02 Reshad Rahman Request for Early review by YANGDOCTORS Completed: On the Right Track. Reviewer: Reshad Rahman. Sent review to list.
2024-07-23
02 Mehmet Ersue Request for Early review by YANGDOCTORS is assigned to Reshad Rahman
2024-07-22
02 Kent Watsen Requested Early review by YANGDOCTORS
2024-06-25
02 Qiufang Ma New version available: draft-ietf-netmod-schedule-yang-02.txt
2024-06-25
02 Mohamed Boucadair New version approved
2024-06-25
02 (System) Request for posting confirmation emailed to previous authors: Daniel King , Mohamed Boucadair , Qin WU , Qiufang Ma
2024-06-25
02 Qiufang Ma Uploaded new revision
2024-04-27
01 Qiufang Ma New version available: draft-ietf-netmod-schedule-yang-01.txt
2024-04-27
01 (System) New version approved
2024-04-27
01 (System) Request for posting confirmation emailed to previous authors: Daniel King , Mohamed Boucadair , Qin WU , Qiufang Ma
2024-04-27
01 Qiufang Ma Uploaded new revision
2024-04-16
00 Kent Watsen This document now replaces draft-ma-opsawg-schedule-yang instead of None
2024-04-16
00 Qiufang Ma New version available: draft-ietf-netmod-schedule-yang-00.txt
2024-04-16
00 Kent Watsen WG -00 approved
2024-04-15
00 Qiufang Ma Set submitter to "Qiufang Ma ", replaces to draft-ma-opsawg-schedule-yang and sent approval email to group chairs: netmod-chairs@ietf.org
2024-04-15
00 Qiufang Ma Uploaded new revision