<html><head><meta http-equiv="Content-Type" content="text/html charset=us-ascii"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">WG-FI is using Asciidoc for the&nbsp;<a href="https://github.com/KantaraInitiative/SAMLprofiles/" class="">Fedinterop Profile</a>. The layout is pretty close to the Word template for Kantara reports.<div class=""><br class=""></div><div class="">Asciidoc is good enough for technical documentation of medium complexity, much more powerful than Markdown, but again with a learning curve. We are using a simple Github/Asciidoctor/<a href="http://github.io" class="">github.io</a> tool chain to edit, versionate, generate and publish pdf and html. There is a docbook backand as well, but we found no need so far to try this.</div><div class=""><div class=""><br class=""><div class="">- Rainer</div><div class=""><br class=""></div><div class=""><br class=""><div><blockquote type="cite" class=""><div class="">Am 14.09.2016 um 18:58 schrieb Andrew Hughes &lt;<a href="mailto:andrewhughes3000@gmail.com" class="">andrewhughes3000@gmail.com</a>&gt;:</div><br class="Apple-interchange-newline"><div class=""><div dir="ltr" class="">This is exactly the core of the question I'm trying to explore...<div class=""><br class=""></div><div class="">I'm trying to find some kind of balance between powerful-but-nasty formats and tools and the capabilities for community contribution.</div><div class=""><br class=""></div><div class="">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.&nbsp;</div><div class="">(any and all dissenting opinions welcome - please!)</div><div class=""><br class=""></div><div class="">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's only a work around.</div><div class=""><br class=""></div><div class="">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. "applies to LOA level x" etc)</div><div class=""><br class=""></div><div class=""><br class=""></div><div class="">So that's why I'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 class=""><br class=""></div><div class=""><br class=""></div><div class="">andrew.</div><div class=""><br class=""></div><div class=""><br class=""></div><div class="">BTW nice artwork! I'm very glad that doc editing tools have progressed since then. Seems like a difficult format to correct typos &nbsp; ;-)</div><div class=""><br class=""></div><div class=""><br class=""></div><div class=""><br class=""></div></div><div class="gmail_extra"><br clear="all" class=""><div class=""><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr" class=""><div class=""><div dir="ltr" class=""><p class=""><b class="">Andrew Hughes&nbsp;</b><font size="1" class=""><span class="">CISM CISSP</span><span class="">&nbsp;<br class=""></span></font>Independent Consultant<br class=""><b class="">In Turn Information Management Consulting</b></p><p class=""><span style="color:rgb(33,33,33);font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:13.1999998092651px;line-height:19.7999992370605px" class="">o &nbsp;+1 650.209.7542<br class=""></span>m +1 250.888.9474<br class=""><font size="1" class="">
1249 Palmer Road,<br class="">Victoria, BC V8P 2H8</font><br class=""><span class=""><a href="mailto:AndrewHughes3000@gmail.com" target="_blank" class=""><font size="1" class="">AndrewHughes3000@gmail.com</font></a></span><span class=""><font size="1" class="">&nbsp;</font><br class=""></span><font size="1" class=""><a href="http://ca.linkedin.com/pub/andrew-hughes/a/58/682/" target="_blank" class="">ca.linkedin.com/pub/andrew-hughes/a/58/682/</a><br class=""></font><b class=""><font size="1" class="">Identity Management | IT Governance | Information Security&nbsp;</font></b></p></div></div></div></div></div>
<br class=""><div class="gmail_quote">On Wed, Sep 14, 2016 at 9:25 AM, Eve Maler <span dir="ltr" class="">&lt;<a href="mailto:eve@xmlgrrl.com" target="_blank" class="">eve@xmlgrrl.com</a>&gt;</span> wrote:<br class=""><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr" class="">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's what I use for editing xml2rfc), but it's still not for the faint of heart, and it's not free if you want even a minimally "styled" interface:<div class=""><br class=""></div><div class=""><a href="http://www.xmlmind.com/xmleditor/" target="_blank" class="">http://www.xmlmind.com/<wbr class="">xmleditor/</a></div><div class=""><br class=""></div><div class="">Their screenshot of a styled view of a DocBook document:</div><div class=""><br class=""></div><div class=""><a href="http://www.xmlmind.com/xmleditor/screenshots/styled_view.png" target="_blank" class="">http://www.xmlmind.com/<wbr class="">xmleditor/screenshots/styled_<wbr class="">view.png</a><br class=""></div><div class=""><br class=""></div><div class="">My old cross-stitched saying about DocBook: :-)</div><div class=""><br class=""></div><div class=""><a href="http://www.snee.com/xml/xml2004art/pages/07-docbook-pearl-2.htm" target="_blank" class="">http://www.snee.com/xml/<wbr class="">xml2004art/pages/07-docbook-<wbr class="">pearl-2.htm</a><br class=""></div><div class=""><img class=""><span class="HOEnZb"><font color="#888888" class=""><br class=""></font></span></div></div><div class="gmail_extra"><span class="HOEnZb"><font color="#888888" class=""><br clear="all" class=""><div class=""><div data-smartmail="gmail_signature" class=""><div dir="ltr" class=""><div class=""><div dir="ltr" class=""><span style="font-size:12.8px;line-height:normal" class=""><br class=""></span></div><div dir="ltr" class=""><b style="font-size:12.8px;line-height:normal" class="">Eve Maler<br class=""></b><span style="font-size:12.8px;line-height:normal" class="">Cell <a href="tel:%2B1%20425.345.6756" value="+14253456756" target="_blank" class="">+1 425.345.6756</a> | Skype: xmlgrrl | Twitter: @xmlgrrl</span><br class=""></div><div dir="ltr" class=""><span style="font-size:12.8px;line-height:normal" class=""><br class=""></span></div></div></div></div></div></font></span><div class=""><div class="h5">
<br class=""><div class="gmail_quote">On Wed, Sep 14, 2016 at 6:10 PM, Andrew Hughes <span dir="ltr" class="">&lt;<a href="mailto:andrewhughes3000@gmail.com" target="_blank" class="">andrewhughes3000@gmail.com</a>&gt;</span> wrote:<br class=""><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr" class="">Getting there...<div class=""><br class=""></div><div class="">Kantara is piecemeal right now which makes it very hard.&nbsp;</div><span class=""><font color="#888888" class=""><div class=""><br class=""></div><div class="">andrew.</div></font></span></div><div class="gmail_extra"><span class=""><br clear="all" class=""><div class=""><div data-smartmail="gmail_signature" class=""><div dir="ltr" class=""><div class=""><div dir="ltr" class=""><p class=""><b class="">Andrew Hughes&nbsp;</b><font size="1" class=""><span class="">CISM CISSP</span><span class="">&nbsp;<br class=""></span></font>Independent Consultant<br class=""><b class="">In Turn Information Management Consulting</b></p><p class=""><span style="color:rgb(33,33,33);font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:13.1999998092651px;line-height:19.7999992370605px" class="">o &nbsp;<a href="tel:%2B1%20650.209.7542" value="+16502097542" target="_blank" class="">+1 650.209.7542</a><br class=""></span>m <a href="tel:%2B1%20250.888.9474" value="+12508889474" target="_blank" class="">+1 250.888.9474</a><br class=""><font size="1" class="">
1249 Palmer Road,<br class="">Victoria, BC V8P 2H8</font><br class=""><span class=""><a href="mailto:AndrewHughes3000@gmail.com" target="_blank" class=""><font size="1" class="">AndrewHughes3000@gmail.com</font></a></span><span class=""><font size="1" class="">&nbsp;</font><br class=""></span><font size="1" class=""><a href="http://ca.linkedin.com/pub/andrew-hughes/a/58/682/" target="_blank" class="">ca.linkedin.com/pub/andrew-hug<wbr class="">hes/a/58/682/</a><br class=""></font><b class=""><font size="1" class="">Identity Management | IT Governance | Information Security&nbsp;</font></b></p></div></div></div></div></div>
<br class=""></span><div class=""><div class=""><div class="gmail_quote">On Wed, Sep 14, 2016 at 8:54 AM, John Wunderlich <span dir="ltr" class="">&lt;<a href="mailto:john@wunderlich.ca" target="_blank" class="">john@wunderlich.ca</a>&gt;</span> wrote:<br class=""><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr" class=""><div class="gmail_default" style="font-family:verdana,sans-serif;font-size:small;color:#073763">I'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's clear, I'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 class=""></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't know what tool (or tools) I should be using.</div></div><div class="gmail_extra"><br clear="all" class=""><div class=""><div data-smartmail="gmail_signature" class=""><div dir="ltr" class=""><div class=""><div dir="ltr" class=""><div class=""><div dir="ltr" class=""><div class=""><div dir="ltr" class=""><div class=""><div class=""><br class=""></div><font face="verdana,sans-serif" class="">Sincerely,<br class="">John Wunderlich<br class=""><a href="https://twitter.com/PrivacyCDN" target="_blank" class="">@PrivacyCDN</a><br class=""></font><span class=""><br class=""></span><font face="verdana,sans-serif" class="">Call: <a href="tel:%2B1%20%28647%29%20669-4749" value="+16476694749" target="_blank" class="">+1 (647) 669-4749</a><br class="">eMail: <a href="mailto:john@wunderlich.ca" target="_blank" class="">john@wunderlich.ca</a></font><font face="verdana,sans-serif" class=""><br class=""></font></div></div></div></div></div></div></div></div></div></div>
<br class=""><div class="gmail_quote"><div class=""><div class="">On 14 September 2016 at 09:08, Andrew Hughes <span dir="ltr" class="">&lt;<a href="mailto:andrewhughes3000@gmail.com" target="_blank" class="">andrewhughes3000@gmail.com</a>&gt;</span> wrote:<br class=""></div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class=""><div class=""><div dir="ltr" class="">Hi LC - another question about tools and document formats and markup languages...<div class=""><br class=""></div><div class="">DocBook</div><div class="">LaTeX</div><div class=""><br class=""></div><div class="">Do either of those tools/formats strike terror in you? If so, please let me know.</div><div class=""><br class=""></div><div class="">I'm just exploring options in the space, so don't panic yet.&nbsp;</div><div class=""><br class=""></div><div class="">If you haven't guessed, I'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 'normal' explanatory documents. Also includes normative narrative documents - policy documents if you like.</div><div class=""><br class=""></div><div class="">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 class=""><br class=""></div><div class="">A markdown-flavour rendering of the master document would be posted to a github project for ongoing issue tracking and community input.</div><div class=""><br class=""></div><div class="">Am I crazy for looking at this tool chain?<br clear="all" class=""><div class=""><div data-smartmail="gmail_signature" class=""><div dir="ltr" class=""><div class=""><div dir="ltr" class=""><p class=""><b class="">Andrew Hughes&nbsp;</b><font size="1" class=""><span class="">CISM CISSP</span><span class="">&nbsp;<br class=""></span></font>Independent Consultant<br class=""><b class="">In Turn Information Management Consulting</b></p><p class=""><span style="color:rgb(33,33,33);font-family:'Helvetica Neue',Helvetica,Arial,sans-serif;font-size:13.1999998092651px;line-height:19.7999992370605px" class="">o &nbsp;<a href="tel:%2B1%20650.209.7542" value="+16502097542" target="_blank" class="">+1 650.209.7542</a><br class=""></span>m <a href="tel:%2B1%20250.888.9474" value="+12508889474" target="_blank" class="">+1 250.888.9474</a><br class=""><font size="1" class="">
1249 Palmer Road,<br class="">Victoria, BC V8P 2H8</font><br class=""><span class=""><a href="mailto:AndrewHughes3000@gmail.com" target="_blank" class=""><font size="1" class="">AndrewHughes3000@gmail.com</font></a></span><span class=""><font size="1" class="">&nbsp;</font><br class=""></span><font size="1" class=""><a href="http://ca.linkedin.com/pub/andrew-hughes/a/58/682/" target="_blank" class="">ca.linkedin.com/pub/andrew-hug<wbr class="">hes/a/58/682/</a><br class=""></font><b class=""><font size="1" class="">Identity Management | IT Governance | Information Security&nbsp;</font></b></p></div></div></div></div></div>
</div></div>
<br class=""></div></div>______________________________<wbr class="">_________________<br class="">
LC mailing list<br class="">
<a href="mailto:LC@kantarainitiative.org" target="_blank" class="">LC@kantarainitiative.org</a><br class="">
<a href="http://kantarainitiative.org/mailman/listinfo/lc" rel="noreferrer" target="_blank" class="">http://kantarainitiative.org/m<wbr class="">ailman/listinfo/lc</a><br class="">
<br class=""></blockquote></div><br class=""></div>

<br class="">
<div style="font-family:Arial,Helvetica,sans-serif;font-size:1.3em" class=""><br class=""></div><div class=""><font face="Arial, Helvetica, sans-serif" size="1" class="">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 class=""></div></div></div>
<br class="">______________________________<wbr class="">_________________<br class="">
LC mailing list<br class="">
<a href="mailto:LC@kantarainitiative.org" target="_blank" class="">LC@kantarainitiative.org</a><br class="">
<a href="http://kantarainitiative.org/mailman/listinfo/lc" rel="noreferrer" target="_blank" class="">http://kantarainitiative.org/m<wbr class="">ailman/listinfo/lc</a><br class="">
<br class=""></blockquote></div><br class=""></div></div></div>
</blockquote></div><br class=""></div>
_______________________________________________<br class="">LC mailing list<br class=""><a href="mailto:LC@kantarainitiative.org" class="">LC@kantarainitiative.org</a><br class="">http://kantarainitiative.org/mailman/listinfo/lc<br class=""></div></blockquote></div><br class=""></div></div></div></body></html>