Good point, maybe we should have our own short style guide based on e.g.:
1. http://www.iso.org/iso/guidance-for-writing-standards-for-smes.pdf
2.
http://isotc.iso.org/livelink/livelink/fetch/2000/2122/4230450/4230456/ISO_IEC_Directives%2C_Part_2%2C_Rules_for_the_structure_and_drafting_of_International_Standards_%282011%2C_6th_edition%29%28PDF_format%29_.pdf?nodeid=10562502&vernum=-2
Thanks,
M.D.
On 25/04/2016 11:22 PM, Alex Wight (awight) wrote:
/[Resending w/o opaque-signed S/MIME]/
Hi Dean et. al,
I'd like to address a formatting issue I've run into several times
while attempting to search for something within the Baseline
Requirements or copying+pasting from the document.
In the Baseline Requirements PDF document, unnecessary whitespace
such as a tab character is introduced such that a couple of problems
arise:
1) Searching for certain terms within the document becomes extremely
difficult and tedious. For example, I was searching for the exact
verbiage around an "Internal Name" and I typed "Internal" into the
search box which yielded 25 results. Appending a space character
narrowed the results down to 8, yet none of them were Internal Name.
Appending an "N" reduced the results to zero. Only after manually
scrolling to the definitions and hunting down the line for Internal
Name did I copy and paste it into the search field to see what was
happening. If one searches for "Internal Name" (there's two tab
characters between the words there) results in only the one instance
of this in the definitions section but it doesn't find the instance
within the doc that makes use of the term. To find that, one has to
search for "Internal Name" (only one tab between the words this time),
which produces the results I was initially seeking.
2) Copying and pasting to quote verbiage becomes a formatting
nightmare too. For example, when copying and pasting the text from
section 7.1.2.3f, one gets this (no modification on my part): "/f.
extKeyUsage(required)/
/Eitherthevalueid‐kp‐serverAuth[RFC5280]orid‐kp‐clientAuth[RFC5280]orbothvaluesMUSTbepresent./
/id‐kp‐emailProtection[RFC5280]MAYbepresent.OthervaluesSHOULDNOTbepresent./"
This snippet contains 25 tab characters (!) which, needless to say,
makes beautifying this text an exercise in tedium when conveying it
outside of its original PDF format.
Anyway, I'm not sure it needs to take up any time on the call, but
it's an administrative item that I feel needs addressing somehow.
Thanks,
-Alex Wight
From: <[email protected]> on behalf of
"[email protected] <mailto:[email protected]>"
<[email protected] <mailto:[email protected]>>
Date: Monday, April 25, 2016 at 1:19 PM
To: CABFPub <[email protected]>
Subject: [cabfpub] Call for agenda items for call on April 28th
If you have any agenda items for this week’s call, please send to me
today.
Thanks
Dean
_______________________________________________
Public mailing list
[email protected]
https://cabforum.org/mailman/listinfo/public
_______________________________________________
Public mailing list
[email protected]
https://cabforum.org/mailman/listinfo/public
