<div dir="ltr">Hey folks,<div><br></div><div>Just an update as to where we're at with the GitHub migration and automation.</div><div><br></div><div>As of today [1], the new GitHub Actions based integration has landed to the Server Cert CWG. With this new integration, pull requests to change documents will result in PDFs and Word docs (DOCX) files automatically generated and attached to the Pull Request.</div><div><br></div><div>Further, when you clone the CA/B Forum repository (or sync your repo [2]), your fork / your repository will also automatically build copies for your changes. This hopefully makes it quicker and easier to preview your changes and see how well they work.</div><div><br></div><div>You shouldn't need to do anything special to enable this, but feel free to reach out to the Infrastructure Subcommittee if you run in to any issues.</div><div><br></div><div>There's work on a draft ballot [3] to fixup the SCWG documents so that they are uniform and well-formatted for this set-up. There's still more alignment between the servercert documents that would be useful (e.g. aligning to RFC 3647 is one possibility, but even simpler, whether lists used Roman numerals, Arabic numerals, lowercase letters, uppercase letters, at each level is inconsistent between the docs and within the docs themselves)<br></div><div><br></div><div>In terms of things not supported, which may or may not be supported in the future:</div><div><ul><li>Automatically generated redline final documents (PDF and DOCX) is not supported. There's hope we'll be able to get something for PDFs working, but for now, it will be a manual process.</li><li>Generating HTML variants is not presently supported. We're still trying to figure out how important this is, relative to some of the other efforts, so this may or may not be added back.</li><li>Watermarking the Word docs as DRAFT is not yet supported. Generating non-watermarked PDFs is also not yet supported. We're still working in the Infrastructure Forum Subcommittee about the best flow for generating the docs.</li><li>Generating documents locally is not yet supported. Mostly because there's a fair bit of fiddly bits related to things like fonts and typesetting, so right now, the infrastructure uses Docker to try to get a hermetic environment. If folks find it important to be able to run things locally, letting the Infrastructure Subcommittee know will help us prioritize that.</li></ul><div>Assuming the draft ballot works out, we'll clean up the remaining artifacts in the Servercert repository, and turn down the Travis integration, such that the only real documents left in the repository are the Guidelines themselves.</div></div><div><br></div><div>[1] <a href="https://github.com/cabforum/servercert/commit/8f631282fcb2e637e44bfaa7e58de655c78c1546">https://github.com/cabforum/servercert/commit/8f631282fcb2e637e44bfaa7e58de655c78c1546</a></div><div>[2] <a href="https://wiki.cabforum.org/github_redline_guide#prerequisites">https://wiki.cabforum.org/github_redline_guide#prerequisites</a></div><div>[3] <a href="https://github.com/cabforum/servercert/pull/235">https://github.com/cabforum/servercert/pull/235</a></div></div>