Skip to content
This repository has been archived by the owner on Apr 24, 2020. It is now read-only.

Start AUTH48 processing #484

Merged
merged 5 commits into from Feb 19, 2019
Merged

Start AUTH48 processing #484

merged 5 commits into from Feb 19, 2019

Conversation

bifurcation
Copy link
Contributor

The RFC Editor has completed their editing pass on ACME and assigned us RFC number -- ACME will be RFC 8555 馃帀馃帄

In order to finalize the RFC, we now need to reconcile that with the edits that have come in while they were working, and return to them an updated XML document.

This PR takes the first few steps in that process:

  • Most of the RFC Editor's content changes have been reflected in the Markdown. The ones that are not reflected are ones that I rejected after reviewing them.
  • Adds an rfced directory with:
    • A script clean-xml.py that removes some artifacts that kramdown-rfc2629 introduces
    • The RFC editor's proposed file, rfc8555.xml
    • Some intermediate XML files to help understand the differences between the updated source and what the RFC editor provided:
      • draft-ietf-acme-acme.xml - Raw output from kramdown-xml2rfc
      • draft-ietf-acme-acme.clean.xml - Output from clean-xml.py
      • rfc8555.src-clean.xml - Same content as draft.clean.xml, but has RFC editor's technical XML changes
      • rfc8555.edited.xml - Content is the same as rfc.xml, but has:
        • Whitespace adjustments to facilitate diffs with the above
        • My comments in response to the RFC editor

The authors, chairs, and ADs are currently working on a plan to work this through to completion.

Copy link
Collaborator

@cpu cpu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Both the markdown diff and the XML diff & responses to the RFC editor look good to me. Thanks for making the edits in this branch @bifurcation

rfced::
kramdown-rfc2629 draft-ietf-acme-acme.md >rfced/draft-ietf-acme-acme.xml
cd rfced && python clean-xml.py <draft-ietf-acme-acme.xml >draft-ietf-acme-acme.clean.xml
-cd rfced && diff -u draft-ietf-acme-acme.clean.xml rfc8555.edited.xml >curr.diff
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is -cd a typo?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, the leading minus means ignore exit status from the command-line.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ahhh! That makes sense. Thanks @richsalz

rfced::
kramdown-rfc2629 draft-ietf-acme-acme.md >rfced/draft-ietf-acme-acme.xml
cd rfced && python clean-xml.py <draft-ietf-acme-acme.xml >draft-ietf-acme-acme.clean.xml
-cd rfced && diff -u draft-ietf-acme-acme.clean.xml rfc8555.edited.xml >curr.diff
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, the leading minus means ignore exit status from the command-line.

@bifurcation bifurcation merged commit 9d82df2 into master Feb 19, 2019
This was referenced Feb 19, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants