Meeting Notes: 08-03-2015 ATC/TechComm Meeting

["Dr. Stanley Doherty" <stan@modularwriting.com>]

==================================================== 
  DITA Adoption/TechComm SC Meeting Meeting Notes
                   08-03-2015 
                   12:00PM/EST
==================================================== 
Attendees: Jane, JoAnn, Keith, Bob, Joe, Don, Stan

A. Action Items
====================================================
   1. Release management whitepaper
      > Keith - (if necessary) enter final updates and 
        get updated sources to Bob
      > Bob - generate a final PDF using the OASIS DITA plugin
      > Bob and Keith - release the whitepaper

   2. Release management DITA-OT plug-in
      > Stan - test the most recent plug-in that Tom Cihak uploaded
      > Stan - send an email to the ATC summarizing status
 
   3. DITA 1.3 A-Z Whitepaper
      > Keith - enter final updates and get updated sources to Bob
      > Bob - generate a final PDF using the OASIS DITA plugin
      > Bob and Keith - release the whitepaper

   4. Scoped keys whitepaper
      > ATC - Review by Friday, send comments to Leigh and to 
        the ATC list
      > https://www.oasis-open.org/apps/org/workgroup/dita-adoption/download.php/56130/ScopedKeysFeatureArticle.pdf
 
   5. Short description whitepaper
      > ATC - Review by Friday, send comments to Leigh and to 
        the ATC list
      > https://www.oasis-open.org/apps/org/workgroup/dita-adoption/download.php/56218/shortdesc_article.pdf
 
   6. dita.xml.org
      > Keith - review the remaining TBD sections of the
        dita.xml.org Knowledgebase.
      > Bob - run a site scraping tool against all the 
        on dita.xml.org to build a repository of its 
        contents.
      > Stan - dig out his slides on "top reasons" NOT to move
        to DITA and forward to the ATC list.
 
==================================================== 
B. Discussion Notes
==================================================== 

   1. Triage (review) the existing dita.xml.org content to determine
      whether articles there should be:
      a. Removed eventually
      b. Preserved
      c. Revised and re-integrated
      d. Replaced with something else
 
      TOC signups:
      - http://dita.xml.org/book/dita-wiki-knowledgebase
      - Reviewer                 Chapter Title
        ------------------------ --------------------------------
        JoAnn Hackos             Capabilities of DITA
        TBD                      Setting up DITA
        Stan Doherty             Working with DITA
                                 - See email to ATC list
        TBD                      The DITA Open Toolkit
        TBD                      DITA Community
        Keith Schengili-Roberts  The Business Case for DITA
                                 - See email to ATC list
        M. Priestly/A. Swope     The DITA Maturity Model
                                 - Don has a DITA-sourced version
        Bob Thomas               DITA Specializations Development
                                 - See email to ATC list
        TBD                      DITA Standards Development
 
   2. Summary comments - dita.xml.org review
      > Much of the content there is sparsely written, outdated, or
        irrelevant to DITA 1.3 users. 
      > ATC attendees converged on the opinion that proceeding from
        the current outline would not be wise.
      > ATC attendees propsed a bottom-up approach to reorganizing 
        the site ... starting with audience analysis.

   3. Audience analysis brainstorming - dita.xml.org review 
      > Specify audience types in the actual articles
      > Revisit the audience profiles at the next meeting

      a. Newbies (froshpeople) - just being exposed to DITA, quite probably
         developing a business case or first prototypes for DITA
         1) Newbie manager - wants information on previous business 
            cases, wants logic behind a migration
            - Example - the Nokia buiness case
         2) Newbie information architect - wants information about
            design decisions, gotchas, et al.
         3) Newbie writer - wants information about how to get 
            started with DITA
         4) Newbie translation manager - wants information about 
            best practices and pitfalls
         5) Newbie tech support professional or implementor - wants 
            information about tools configuration and basic
            customization issues (including specialization)

      b. First-year adopters (sophomores) - have been working in DITA
         for a year and want to profile ROI and to assess 
         next-generation investment points.
         > Reuse strategies
         > Metadata investments
         > New domain vocabularies
         > Intrinsic XML benefits

   4. DITA SWOT (Strengths, weaknesses, opportunities, threats) wiki      
      a. "Why choose not to move to DITA?"
         > Capture the top ten reasons companies and departments 
           ultimately decide NOT to 
         > Correlate these reasons with the CIDM survey results on 
           DITA productivity
           - https://www.infomanagementcenter.com/wp-content/uploads/2014/10/BP2014-12JHackos.pdf
      b. How NOT to get trapped early in your implementation.
         > Example - do topic typing from day-1
         > Example - have story about interoperating with company
           wikis (Confluence, MindTouch)