<div dir="ltr"><div>Sorry, we (infrastructure) still haven't wired up automation to make this even more discoverable for folks not using GitHub daily :)</div><div><br></div><div>On <a href="https://github.com/sleevi/cabforum-docs/pull/36">https://github.com/sleevi/cabforum-docs/pull/36</a> , you can click the "Checks" tab ( <a href="https://github.com/sleevi/cabforum-docs/pull/36/checks">https://github.com/sleevi/cabforum-docs/pull/36/checks</a> ) to see the actions, and then click either of the "Build Guidelines Actions" runs to download the artifacts (at the bottom of the page)</div><div><br></div><div>You can also click the green checkmark next to any commit in a branch (e.g. on <a href="https://github.com/sleevi/cabforum-docs/tree/profiles">https://github.com/sleevi/cabforum-docs/tree/profiles</a> or <a href="https://github.com/sleevi/cabforum-docs/commits/profiles">https://github.com/sleevi/cabforum-docs/commits/profiles</a> ) to access the artifacts for that commit (or batch of commits).</div><div><br></div><div>That will have the generated word and PDF files. The word file, due to the Word bug/quirk I mentioned ( <a href="https://github.com/jgm/pandoc/issues/458">https://github.com/jgm/pandoc/issues/458</a> ) requires you click the refresh button on the ToC to regenerate it once you open, but it should generate the right ToC.</div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Aug 2, 2021 at 12:48 PM Doug Beattie <<a href="mailto:doug.beattie@globalsign.com">doug.beattie@globalsign.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div lang="EN-US" style="overflow-wrap: break-word;"><div class="gmail-m_-7252844833315563014WordSection1"><p class="MsoNormal">I viewed the file in GitHub and copied into word to generate the ToC, but for the life if me could not find the link to the PDF, so I’ll poke around a bit more.<u></u><u></u></p><p class="MsoNormal"><u></u> <u></u></p><p class="MsoNormal">Now that has one more level than the current BRs, those headings are present and will make (my) navigation to the applicable section much easier.  And of course being compliant with RFC 3647 which I wasn’t thinking of when I sent my comments, so no issues with that. Sorry!<u></u><u></u></p><p class="MsoNormal"><u></u> <u></u></p><p class="MsoNormal"><u></u> <u></u></p><p class="MsoNormal">I’m not a huge fan of the “Common CA fields” where it is vs. with the CA profiles, same with “common Certificate fields”, but I can cope with that.  A small bug in the numbering of those last 2 items in your screenshot.<u></u><u></u></p><p class="MsoNormal"><u></u> <u></u></p><p class="MsoNormal">Doug<u></u><u></u></p><p class="MsoNormal"><u></u> <u></u></p><p class="MsoNormal"><u></u> <u></u></p><p class="MsoNormal"><u></u> <u></u></p><p class="MsoNormal"><u></u> <u></u></p><p class="MsoNormal"><u></u> <u></u></p><div style="border-right:none;border-bottom:none;border-left:none;border-top:1pt solid rgb(225,225,225);padding:3pt 0in 0in"><p class="MsoNormal"><b>From:</b> Ryan Sleevi <<a href="mailto:sleevi@google.com" target="_blank">sleevi@google.com</a>> <br><b>Sent:</b> Monday, August 2, 2021 11:54 AM<br><b>To:</b> Ryan Sleevi <<a href="mailto:sleevi@google.com" target="_blank">sleevi@google.com</a>>; CA/Browser Forum Validation SC List <<a href="mailto:validation@cabforum.org" target="_blank">validation@cabforum.org</a>><br><b>Cc:</b> Doug Beattie <<a href="mailto:doug.beattie@globalsign.com" target="_blank">doug.beattie@globalsign.com</a>><br><b>Subject:</b> Re: [cabf_validation] Cert Profile spec: question about the outline/ToC<u></u><u></u></p></div><p class="MsoNormal"><u></u> <u></u></p><div><div><p class="MsoNormal">And for completeness: This is what the PDF produced looks like from the canonical markdown:<u></u><u></u></p></div><div><p class="MsoNormal"><u></u> <u></u></p></div><p class="MsoNormal"><img width="562" height="217" style="width: 5.8541in; height: 2.2604in;" id="gmail-m_-7252844833315563014Picture_x0020_1" src="cid:17b07e628434cff311"><u></u><u></u></p><div><p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">That said, I haven't really paid attention to the Word file, as I don't use it, but could you confirm the process you're using to generate the table of contents? It should be generated with four levels of depth, like above - the Word default is 3 levels, so if you're manually doing the generation, this may explain. It looks like there's a slight bug in Word that <a href="https://github.com/jgm/pandoc/issues/458" target="_blank">we don't have a way to work around</a> related to how it generates the TOC, but if you're manually replacing the ToC, that may explain why you don't have a matching experience.<u></u><u></u></p></div></div><p class="MsoNormal"><u></u> <u></u></p><div><div><p class="MsoNormal">On Mon, Aug 2, 2021 at 11:48 AM Ryan Sleevi via Validation <<a href="mailto:validation@cabforum.org" target="_blank">validation@cabforum.org</a>> wrote:<u></u><u></u></p></div><blockquote style="border-top:none;border-right:none;border-bottom:none;border-left:1pt solid rgb(204,204,204);padding:0in 0in 0in 6pt;margin-left:4.8pt;margin-right:0in"><div><div><p class="MsoNormal">Hey Doug,<u></u><u></u></p></div><div><p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">Thanks for the suggestion!<u></u><u></u></p></div><div><p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">I think you may recall that we had at least two calls where we discussed this outline, early on, in order to gather feedback early on, so that it wouldn't require major restructuring. That's not to say no, but that this isn't exactly a light request.<u></u><u></u></p></div><div><p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">There's a clear problem with your proposal, which is that it relies on breaking from RFC 3647 format. Considering multiple root programs, and the BRs itself, require CAs to adhere to RFC 3647, that's a somewhat big divergence here, and I want to call attention to it.<u></u><u></u></p></div><div><p class="MsoNormal"><u></u> <u></u></p></div><div><p class="MsoNormal">I'll certainly give it some thought, but I'm hoping as well you can better explain your concern: Is your primary concern simply the Table of Contents on the main PDF? I'm not sure I understand "avoid long numbered headings" in and of itself as a goal, especially since we have other places (and within the NCSSRs, but <i>especially</i> the EVGs), so it does seem you're proposing a more substantial requirement that is inconsistent with our existing work. That doesn't mean it's bad, but it seems we should try to aim to be self-consistent to a degree, shouldn't we?<u></u><u></u></p></div></div><p class="MsoNormal">_______________________________________________<br>Validation mailing list<br><a href="mailto:Validation@cabforum.org" target="_blank">Validation@cabforum.org</a><br><a href="https://lists.cabforum.org/mailman/listinfo/validation" target="_blank">https://lists.cabforum.org/mailman/listinfo/validation</a><u></u><u></u></p></blockquote></div></div></div></blockquote></div></div>