This is the working area for the DNSOP Internet-Draft, "Domain Control Validation using DNS" (previously called "Domain Verification Techniques using DNS").
The repo uses Martin Thomson's I-D template.
Formatted text and HTML versions of the draft can be built using make
.
$ make
This requires that you have the necessary software installed. See
the instructions. For this I-D, Markdown is the canonical source, so kramdown-rfc2629
is what I use. This must be installed in addition to the right version of make
and xml2rfc
(yay, software) - please check the SETUP doc for details.
Also note that main
is the default and working branch.
Once you have everything set up correctly, the usual flow is:
$ make
This generates the .txt
and .html
outputs.
To automatically fix lints:
$ make fix-lint
Then do a git commit
. Note that a git commit will typically fail if the lint check fails.
Current datatracker version is 6
. Next version will be 7
.
When you're ready to cut a new version, do:
make
make next # this generates the versioned doc
# Once you're happy with it, upload the XML file generated in versioned/
# https://datatracker.ietf.org/submit/
# Then, upload the new tag to GitHub
git tag draft-ietf-dnsop-domain-verification-techniques-07
git push origin draft-ietf-dnsop-domain-verification-techniques-07
This is the manual process outlined in the I-D template docs.
See the guidelines for contributions.