In the IETF GeoJSON WG we're using the technique described in RFC 7328 -- Writing I-Ds and RFCs Using Pandoc and a Bit of XML to write our drafts and GitHub to collaborate on the Markdown sources. I've configured CircleCI to build HTML, nroff, text, and XML editions of the draft on each push and pull request to catch issues that break the draft building toolchain. I'm not fluent with RFC editor XML and mess up the tagging regularly, so this is helping the WG quite a bit.
Recently I woke up to the possibilities in saving the text and HTML editions as
CircleCI build artifacts. Here's the
circle.yml file from
machine: python: version: 2.7.10 dependencies: pre: - sudo apt-get update; sudo apt-get install pandoc - pip install -U pip - pip install xml2rfc test: override: - make - head draft.txt general: artifacts: - draft.txt - draft.html
I should have done this sooner! I may look into including some of the IETF tools like idnits and idspell.