<div dir="ltr">This is exactly the core of the question I&#39;m trying to explore...<div><br></div><div>I&#39;m trying to find some kind of balance between powerful-but-nasty formats and tools and the capabilities for community contribution.</div><div><br></div><div>Kantara has a problem that we are using word processing tools (layout and presentation focus) to do document editing (content, semantics, structure focus) - this causes real problems with document maintenance. </div><div>(any and all dissenting opinions welcome - please!)</div><div><br></div><div>A specific example: The Service Assessment Criteria (SAC) are maintained in Word. The Track Changes feature is used to try and capture change records in the document. But our power-users take the Word version and immediately convert it to spreadsheets to do compliance assessments. IAWG has manually created an xls version of the SAC that was current at the time - but that&#39;s only a work around.</div><div><br></div><div>There is no (simple-ish) way to automate different publication formats with this use of Word format as the canonical source. Yes, I know there are scripts and conversion tools available - but the Word source uses format styling to capture semantic structures (e.g. &quot;applies to LOA level x&quot; etc)</div><div><br></div><div><br></div><div>So that&#39;s why I&#39;m asking the question of using a structured document format/tool for the master versions, and using a lightweight markup rendering in something like github to do community input/maintenance...</div><div><br></div><div><br></div><div>andrew.</div><div><br></div><div><br></div><div>BTW nice artwork! I&#39;m very glad that doc editing tools have progressed since then. Seems like a difficult format to correct typos   ;-)</div><div><br></div><div><br></div><div><br></div></div><div class="gmail_extra"><br clear="all"><div><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr">







<p><b>Andrew Hughes </b><font size="1"><span>CISM CISSP</span><span> <br></span></font>Independent Consultant<br><b>In Turn Information Management Consulting</b></p><p><span style="color:rgb(33,33,33);font-family:&#39;Helvetica Neue&#39;,Helvetica,Arial,sans-serif;font-size:13.1999998092651px;line-height:19.7999992370605px">o  +1 650.209.7542<br></span>m +1 250.888.9474<br><font size="1">
1249 Palmer Road,<br>Victoria, BC V8P 2H8</font><br><span><a href="mailto:AndrewHughes3000@gmail.com" target="_blank"><font size="1">AndrewHughes3000@gmail.com</font></a></span><span><font size="1"> </font><br></span><font size="1"><a href="http://ca.linkedin.com/pub/andrew-hughes/a/58/682/" target="_blank">ca.linkedin.com/pub/andrew-hughes/a/58/682/</a><br></font><b><font size="1">Identity Management | IT Governance | Information Security </font></b></p></div></div></div></div></div>
<br><div class="gmail_quote">On Wed, Sep 14, 2016 at 9:25 AM, Eve Maler <span dir="ltr">&lt;<a href="mailto:eve@xmlgrrl.com" target="_blank">eve@xmlgrrl.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">DocBook (or DITA, which it seems is more popular for tech doc these days) is an XML format and requires XML editing. What editing environment are you thinking of? XMLmind is probably one of the very few reasonable choices (it&#39;s what I use for editing xml2rfc), but it&#39;s still not for the faint of heart, and it&#39;s not free if you want even a minimally &quot;styled&quot; interface:<div><br></div><div><a href="http://www.xmlmind.com/xmleditor/" target="_blank">http://www.xmlmind.com/<wbr>xmleditor/</a></div><div><br></div><div>Their screenshot of a styled view of a DocBook document:</div><div><br></div><div><a href="http://www.xmlmind.com/xmleditor/screenshots/styled_view.png" target="_blank">http://www.xmlmind.com/<wbr>xmleditor/screenshots/styled_<wbr>view.png</a><br></div><div><br></div><div>My old cross-stitched saying about DocBook: :-)</div><div><br></div><div><a href="http://www.snee.com/xml/xml2004art/pages/07-docbook-pearl-2.htm" target="_blank">http://www.snee.com/xml/<wbr>xml2004art/pages/07-docbook-<wbr>pearl-2.htm</a><br></div><div><img><span class="HOEnZb"><font color="#888888"><br></font></span></div></div><div class="gmail_extra"><span class="HOEnZb"><font color="#888888"><br clear="all"><div><div data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><span style="font-size:12.8px;line-height:normal"><br></span></div><div dir="ltr"><b style="font-size:12.8px;line-height:normal">Eve Maler<br></b><span style="font-size:12.8px;line-height:normal">Cell <a href="tel:%2B1%20425.345.6756" value="+14253456756" target="_blank">+1 425.345.6756</a> | Skype: xmlgrrl | Twitter: @xmlgrrl</span><br></div><div dir="ltr"><span style="font-size:12.8px;line-height:normal"><br></span></div></div></div></div></div></font></span><div><div class="h5">
<br><div class="gmail_quote">On Wed, Sep 14, 2016 at 6:10 PM, Andrew Hughes <span dir="ltr">&lt;<a href="mailto:andrewhughes3000@gmail.com" target="_blank">andrewhughes3000@gmail.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Getting there...<div><br></div><div>Kantara is piecemeal right now which makes it very hard. </div><span><font color="#888888"><div><br></div><div>andrew.</div></font></span></div><div class="gmail_extra"><span><br clear="all"><div><div data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr">







<p><b>Andrew Hughes </b><font size="1"><span>CISM CISSP</span><span> <br></span></font>Independent Consultant<br><b>In Turn Information Management Consulting</b></p><p><span style="color:rgb(33,33,33);font-family:&#39;Helvetica Neue&#39;,Helvetica,Arial,sans-serif;font-size:13.1999998092651px;line-height:19.7999992370605px">o  <a href="tel:%2B1%20650.209.7542" value="+16502097542" target="_blank">+1 650.209.7542</a><br></span>m <a href="tel:%2B1%20250.888.9474" value="+12508889474" target="_blank">+1 250.888.9474</a><br><font size="1">
1249 Palmer Road,<br>Victoria, BC V8P 2H8</font><br><span><a href="mailto:AndrewHughes3000@gmail.com" target="_blank"><font size="1">AndrewHughes3000@gmail.com</font></a></span><span><font size="1"> </font><br></span><font size="1"><a href="http://ca.linkedin.com/pub/andrew-hughes/a/58/682/" target="_blank">ca.linkedin.com/pub/andrew-hug<wbr>hes/a/58/682/</a><br></font><b><font size="1">Identity Management | IT Governance | Information Security </font></b></p></div></div></div></div></div>
<br></span><div><div><div class="gmail_quote">On Wed, Sep 14, 2016 at 8:54 AM, John Wunderlich <span dir="ltr">&lt;<a href="mailto:john@wunderlich.ca" target="_blank">john@wunderlich.ca</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_default" style="font-family:verdana,sans-serif;font-size:small;color:#073763">I&#39;d be more concerned with a clear articulation of an authoring, collaboration and publishing workflow and nailing down the tools for each stage and the transitions between stages. If that&#39;s clear, I&#39;m willing to learn the tools and processes for the stages that I will engage in.</div><div class="gmail_default" style="font-family:verdana,sans-serif;font-size:small;color:#073763"><br></div><div class="gmail_default" style="font-family:verdana,sans-serif;font-size:small;color:#073763">The problem for me would be a lack of clarity or direction so that at any stage in workflow I don&#39;t know what tool (or tools) I should be using.</div></div><div class="gmail_extra"><br clear="all"><div><div data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div><br></div><font face="verdana,sans-serif">Sincerely,<br>John Wunderlich<br><a href="https://twitter.com/PrivacyCDN" target="_blank">@PrivacyCDN</a><br></font><span><br></span><font face="verdana,sans-serif">Call: <a href="tel:%2B1%20%28647%29%20669-4749" value="+16476694749" target="_blank">+1 (647) 669-4749</a><br>eMail: <a href="mailto:john@wunderlich.ca" target="_blank">john@wunderlich.ca</a></font><font face="verdana,sans-serif"><br></font></div></div></div></div></div></div></div></div></div></div>
<br><div class="gmail_quote"><div><div>On 14 September 2016 at 09:08, Andrew Hughes <span dir="ltr">&lt;<a href="mailto:andrewhughes3000@gmail.com" target="_blank">andrewhughes3000@gmail.com</a>&gt;</span> wrote:<br></div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div><div dir="ltr">Hi LC - another question about tools and document formats and markup languages...<div><br></div><div>DocBook</div><div>LaTeX</div><div><br></div><div>Do either of those tools/formats strike terror in you? If so, please let me know.</div><div><br></div><div>I&#39;m just exploring options in the space, so don&#39;t panic yet. </div><div><br></div><div>If you haven&#39;t guessed, I&#39;m thinking of better ways to store, maintain and publish the Kantara ID Assurance Framework documents. These include the Service Assessment Criteria - a highly structured set of criteria that have many internal and external cross linkages. Also includes &#39;normal&#39; explanatory documents. Also includes normative narrative documents - policy documents if you like.</div><div><br></div><div>My early thought is to use DocBook (an OASIS standard) to maintain the canonical master versions. A variety of output formats would be available: .docx, .pdf, .xlsx (for some), .html</div><div><br></div><div>A markdown-flavour rendering of the master document would be posted to a github project for ongoing issue tracking and community input.</div><div><br></div><div>Am I crazy for looking at this tool chain?<br clear="all"><div><div data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr">







<p><b>Andrew Hughes </b><font size="1"><span>CISM CISSP</span><span> <br></span></font>Independent Consultant<br><b>In Turn Information Management Consulting</b></p><p><span style="color:rgb(33,33,33);font-family:&#39;Helvetica Neue&#39;,Helvetica,Arial,sans-serif;font-size:13.1999998092651px;line-height:19.7999992370605px">o  <a href="tel:%2B1%20650.209.7542" value="+16502097542" target="_blank">+1 650.209.7542</a><br></span>m <a href="tel:%2B1%20250.888.9474" value="+12508889474" target="_blank">+1 250.888.9474</a><br><font size="1">
1249 Palmer Road,<br>Victoria, BC V8P 2H8</font><br><span><a href="mailto:AndrewHughes3000@gmail.com" target="_blank"><font size="1">AndrewHughes3000@gmail.com</font></a></span><span><font size="1"> </font><br></span><font size="1"><a href="http://ca.linkedin.com/pub/andrew-hughes/a/58/682/" target="_blank">ca.linkedin.com/pub/andrew-hug<wbr>hes/a/58/682/</a><br></font><b><font size="1">Identity Management | IT Governance | Information Security </font></b></p></div></div></div></div></div>
</div></div>
<br></div></div>______________________________<wbr>_________________<br>
LC mailing list<br>
<a href="mailto:LC@kantarainitiative.org" target="_blank">LC@kantarainitiative.org</a><br>
<a href="http://kantarainitiative.org/mailman/listinfo/lc" rel="noreferrer" target="_blank">http://kantarainitiative.org/m<wbr>ailman/listinfo/lc</a><br>
<br></blockquote></div><br></div>

<br>
<div style="font-family:Arial,Helvetica,sans-serif;font-size:1.3em"><br></div><div><font face="Arial, Helvetica, sans-serif" size="1">This email and any files transmitted with it are confidential and intended solely for the use of the individual or entity to whom they are addressed. If you have received this email in error please notify the system manager. This message contains confidential information and is intended only for the individual named. If you are not the named addressee you should not disseminate, distribute or copy this e-mail. Please notify the sender immediately by e-mail if you have received this e-mail by mistake and delete this e-mail from your system. If you are not the intended recipient you are notified that disclosing, copying, distributing or taking any action in reliance on the contents of this information is strictly prohibited.</font></div></blockquote></div><br></div></div></div>
<br>______________________________<wbr>_________________<br>
LC mailing list<br>
<a href="mailto:LC@kantarainitiative.org" target="_blank">LC@kantarainitiative.org</a><br>
<a href="http://kantarainitiative.org/mailman/listinfo/lc" rel="noreferrer" target="_blank">http://kantarainitiative.org/m<wbr>ailman/listinfo/lc</a><br>
<br></blockquote></div><br></div></div></div>
</blockquote></div><br></div>