<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"><head><meta http-equiv=Content-Type content="text/html; charset=utf-8"><meta name=Generator content="Microsoft Word 15 (filtered medium)"><!--[if !mso]><style>v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style><![endif]--><style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
span.EmailStyle18
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri",sans-serif;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]--></head><body lang=EN-US link=blue vlink=purple style='word-wrap:break-word'><div class=WordSection1><p class=MsoNormal>In the screenshot below you have 2 sections numbered 7.1.2.4 and 7.1.2.5.<o:p></o:p></p><p class=MsoNormal><o:p> </o:p></p><div style='border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in'><p class=MsoNormal><b>From:</b> Ryan Sleevi <sleevi@google.com> <br><b>Sent:</b> Monday, August 2, 2021 1:30 PM<br><b>To:</b> Doug Beattie <doug.beattie@globalsign.com><br><b>Cc:</b> CA/Browser Forum Validation SC List <validation@cabforum.org><br><b>Subject:</b> Re: [cabf_validation] Cert Profile spec: question about the outline/ToC<o:p></o:p></p></div><p class=MsoNormal><o:p> </o:p></p><div><p class=MsoNormal>Also, I'm still not sure I follow you on what you mean by the numbering bug. Could you try to rephrase what you see as the numbering issue (re: Common CA fields & Common Certificate Fields)?<o:p></o:p></p></div><p class=MsoNormal><o:p> </o:p></p><div><div><p class=MsoNormal>On Mon, Aug 2, 2021 at 1:29 PM Ryan Sleevi <<a href="mailto:sleevi@google.com">sleevi@google.com</a>> wrote:<o:p></o:p></p></div><blockquote style='border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in'><div><div><p class=MsoNormal>Sorry, we (infrastructure) still haven't wired up automation to make this even more discoverable for folks not using GitHub daily :)<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>On <a href="https://github.com/sleevi/cabforum-docs/pull/36" target="_blank">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" target="_blank">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)<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>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" target="_blank">https://github.com/sleevi/cabforum-docs/tree/profiles</a> or <a href="https://github.com/sleevi/cabforum-docs/commits/profiles" target="_blank">https://github.com/sleevi/cabforum-docs/commits/profiles</a> ) to access the artifacts for that commit (or batch of commits).<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>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" target="_blank">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.<o:p></o:p></p></div><p class=MsoNormal><o:p> </o:p></p><div><div><p class=MsoNormal>On Mon, Aug 2, 2021 at 12:48 PM Doug Beattie <<a href="mailto:doug.beattie@globalsign.com" target="_blank">doug.beattie@globalsign.com</a>> wrote:<o:p></o:p></p></div><blockquote style='border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-right:0in'><div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>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.<o:p></o:p></p><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>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!<o:p></o:p></p><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>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.<o:p></o:p></p><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>Doug<o:p></o:p></p><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p><div style='border:none;border-top:solid #E1E1E1 1.0pt;padding:3.0pt 0in 0in 0in'><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><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<o:p></o:p></p></div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p><div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>And for completeness: This is what the PDF produced looks like from the canonical markdown:<o:p></o:p></p></div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p></div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><img border=0 width=562 height=217 style='width:5.8541in;height:2.2604in' id="gmail-m_4068066114890230942gmail-m_-7252844833315563014Picture_x0020_1" src="cid:image001.png@01D787A3.904551C0"><o:p></o:p></p><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p></div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>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.<o:p></o:p></p></div></div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p><div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>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:<o:p></o:p></p></div><blockquote style='border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt'><div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>Hey Doug,<o:p></o:p></p></div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p></div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>Thanks for the suggestion!<o:p></o:p></p></div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p></div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>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.<o:p></o:p></p></div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p></div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>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.<o:p></o:p></p></div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <o:p></o:p></p></div><div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>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?<o:p></o:p></p></div></div><p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>_______________________________________________<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><o:p></o:p></p></blockquote></div></div></div></blockquote></div></div></blockquote></div></div></body></html>