[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [dita-adoption] Agenda: DITA Adoption TC Meeting - 04-07-2020
INDIVIDUAL ACTION ITEMS
1. Keith: Request of Scott McGrath that DITA Adoption have BOTH an
 Âopen source (public) and ATC-only Git repo.
2. Stan: Nag the team on 03-17 about adding comments to DUG wiki.
3. Keith: Notify Scott McGrath that the three Adoption TC subcommittees
 Âare no longer active and should be achived.Â
4. Stan: Include in the Action items email Kathy's notes from CIDM
 ÂDITA basics instructors about common customer pain points:
 Âa. Bridging the DITA mechanisms with what they see in their
   authoring tool.
 Âb. Understanding that DITA content creation is just a part
   of the structured markup publishing ecosystem i.e. that
   they will need other things besides an understanding of
   how to use an authoring tool to create DITA content
 Âc. Relating their existing content creation processes to
   working in DITA (example: just writing the content
   and then figuring out what topic type it is afterwards)
 Âd. Understanding map-level linking behaviors at bottom of
   topics in HTML output
5. Gershon: Prep the discussion about DITA financials.
6. Stan: Capture all the meeting notes about organizing our
 Âapproach to whitepaper publishing.
7. Stan: Draft an ATC handout/flyer for review at the next meeting.
MEETING TOPICS
1. DITA User's Guide (Scott)
 Â>>> Review the roles/tasks for DUG.
 ÂDiscussed audiences and skills for the UDG. Posted notes to the wiki site at:
 Â- https://wiki.oasis-open.org/dita-adoption/DITA_User_Guide
 ÂThe DITA Adoption TC is in the process of creating a DITA User Guide. This
 Âguide is designed to address the following audiences:
 Â* Technical writers: some brand new to DITA and XML, some familiar with
  Âstructured authoring
 Â* Technical editors: some brand new to DITA and XML, some familiar with
  Âstructured authoring
 Â* Senior writers/ISD: some brand new to DITA and XML, some familiar with
  Âstructured authoring. Stubbing out the information design and maps.
  ÂProbably many have deep product knowledge.
 Â* Conversion specialists: familiar with scripting and tools, XML, but might
  Ânot know DITA inheritance/hierarchy/specialization/content models
 Â* Publishing specialists: familiar with style requirements, but might not
  Âknow the DITA-OT or structures.
2. Adoption SC futures (Keith)
 Â- DITA Adoption Focus Area Subcommittee
 Â- DITA Adoption Help Subcommittee
 Â- DITA Adoption Asia Subcommittee
3. DITA migration financials (Gershon)
 Â> Migration clients - did measure investments (both tools and skills)
 Â> Gershon - saw ROI ahead of projections
 Â> Contributors:
  Â- Localization overhead (hit ROI much more quickly)
  Â- Reuse % (hit ROI much more quickly) + team productivity
  Â- Instructional design and writing teams collaborated - driven
   Âfinancially to reduce overhead, + single sourcing brought big ROI
 Â> Tasks could be written by either team (training or ID)
  Â- Stretch goal - feature designers (PMs, Product Owners) could
   Âdraft descriptions and use a concept topics
  Â- SMEs contributing as casual contributors = goals
 ÂAI/Gershon and Keith - get together offline to shape this
   project.
 ÂAI/Gershon - drive the discussion/development
 ÂAI/All - recruit helpers/supporters/MBAs/accountants
 ÂAI/Keith - work up some of the financial info that he has (costs just on L10N ROI)
      - Tagging the input so the TMS is DITA-aware BEFORE the DITA switch-over
       produced great results, clean slate
 ÂAI/Gershon - write up the TM updates/setup -
 ÂAI/wiki eventually
4. Whitepaper authoring / stylesheets:
 Âa. DITA-OT CLI installation and use (Stan)
   > PDF: https://www.oasis-open.org/apps/org/workgroup/dita-adoption/download.php/66664/bookmap_atc_install-tc-stylesheets.pdf
   > Sources: https://www.oasis-open.org/apps/org/workgroup/dita-adoption/download.php/66663/atc_install-tc-stylesheets_02.zip
 Âb. Oxygen Editor plug-in installation and usage (Gershon)
 Âc. Framemaker plug-in installation and usage (Kathy - check on the
   possibility of borrowing a CIDM FM license.
 Âd. XMLmind plug-in installation and usage (Gershon)
 Âe. PDF processors -- coordinate discussiuon with DITA TC about approaching
   processor vendors for licenses.
   > Syncro Soft: Chemistry
   > Miramo
   > RenderX
   > Antenna House
5. Document review options (discussion)
6. Whitepaper updates
 Âa. Review Stan's June 30 email about a DITA conversion
   checklist.
   https://wiki.oasis-open.org/dita-adoption/ditaconversionchecklist#preview
   > Whitepaper check-in a few months
 Âb. Keith: Continue progress on "How keys should be implemented"
   whitepaper (Q3).
 Âc. Keith: Roll the "Future of DITA" presentation into a Spring 2020
   whitepaper.
     AI/Stan - forward to the ATC links to Keith's Boston DITA Users
      ÂGroup presentation on DITA futures.
 Âd. Looking ahead: What is the future of DITA/DITA 2.0 (Keith)?
   > What do I need to know to get ready for 2.0?
   > What should I prep?
   > What would a typical user/group see as changes?
   > Review in the spring as a possible whitepaper.
 Âe. Stan: Complete the conversion of the badging whitepaper
   files in Markdown to DITA 1.3. Â
7. https://dita.xml.org/ futures
 Â> Carol Geyer (Oasis) gets complaints about the site being out of date or
  Âdysfunctional. She is asking us what we plan to do about it long-term.
 ÂAI/Keith - review the emails forwarded by Stan and check it out.
8. DITA 2.0 / LwDITA adoption planning
 ÂAI/Gershon (I believe) - brainstorm about topics that should be
   included in an Adoption whitepaper about "What do I need to do
   to get ready for DITA 2.0?"
 ÂAI/Stan - Touch base with Zoe about her current outline for the
   DITA TC Migration Guide.
 ÂAI/TEAM - Develop a list of questions for vendors about their
   plans for adopting/supporting DITA 2.0 and LwDITA in 2021.
 ÂAI/Scott - Engage the LwDITA SC about their current plans for
   developing or supporting a LwDITA Migration Guide. Â
   > Is there some automation involved with migrating
      DITA 1.3 content to LwDITA?
9. DITA samples development
 Âa. DITA collections
   The CIDM article on sample DITA collections is at:
   > https://www.infomanagementcenter.com/dita-collections/
 Âb. Keith: Spent some more time on the Mitchell airplane manual,
   making the tables accessible. Everything is on my local
   system at this point.
 Âc. Scott: Run the MDITA transform when Keith posts the finished
   B-25 sample work.
 Âd. Stan: Build out some working content badging samples
   to support the writing in the badging whitepaper (Q3).
   > GitHub: https://github.com/StanDoherty/dita-badges   Â
10. Call for participation - opportunities for writing:
 Âa. All: Discuss developing a separate whitepaper on DITA 1.3 flagging
   best practices. Include revision marking and PDF changebar
   processing.
11. Parking lot items
 Âa. Review Scott's May 3 email on DITA/LwDITA 1.0 migration strategy.
   > How do we anticipate LwDITA evolutions?
     > May need to update as the spec evolves.
   > Keep as an email for now; revisit late this year.    Â
     > Eventually turn it into a procedure.
     > Wiki - migration
 Âb. All: Consider creating some LwDITA versions of the content?
   Word/GoogleDoc can be converted to MDITA and from there to HDITA.
     > Whitepaper - another output type
 Âc. LwDITA and HTML5 alignment (XDITA)
12. DITA NA planning
  - Scott -- metrics dashboard
  - Stan - conref push
  - Gershon - next-gen publishing map (pub map)
13. Upcoming ATC meetings
  > Tuesday, May 5
  > Tuesday, June 2
  > Tuesday, July 6
  > Tuesday, August 4
  > Tuesday, September 1
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]