make-baseline

.github/workflows/pull_request_updated.yml

@@ -94,7 +94,7 @@ jobs:
           }
       - name: Test summary line for changes
         run: |
-          echo "${{env.SUMMARY_LINE}}" | grep -qF "0 flaws (~~), 3 warnings (==), 6 comments (--)" || {
+          echo "${{env.SUMMARY_LINE}}" | grep -qF "0 flaws (~~), 3 warnings (==), 5 comments (--)" || {
             echo "::error::Idnits summary line different - examine why (fix workflow if needed)"
             exit 1
           }

designs/README.md

@@ -0,0 +1,11 @@
+As described in CONTRIBUTING, sufficiently complex changes should
+have a design document.
+
+It is possible for a design to be reviewed prior-to or at the
+same time as the updates to the `yang2` document itself.
+
+It is up to the submitter to decide what to put into a design
+document, but notes explaining choices would be good.
+
+Please name the document `<name-of-branch>.md`.
+

designs/make-baseline.md

@@ -0,0 +1,28 @@
+# Design for creating the "yang2" document
+
+## Background
+
+RFC 7950 contains details not specific to data-modeling that should be
+factored out into other documents.  The resulting document, would be a
+good basis for YANG 2.0.
+
+## General Steps
+
+1) Copy `rfc7950.xml` to `draft-yn-netmod-yang2.xml`
+
+  - Note that file `rfc7950.xml` is from the Editor and was updated
+    to `v3` using `xml2rfc --v2v3`.
+
+2) Move XML-encoding details to `draft-yn-netmod-yang-xml.xml`.
+
+  - The `yang-xml` document is in a different GitHub repo, here:
+    https://github.com/netmod-wg/yang-xml.
+
+  - There are XML-comments in `draft-yn-netmod-yang-xml.xml` that
+    point to where content was pulled from in this document.
+
+3) Delete any NETCONF-specific details 
+
+  - It is expected that the NETCONF WG will examine this PR's diff
+    as part of some future NETCONF-next effort.
+