[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Agenda: DITA Adoption TC Meeting - 10-06-2020
==================================================== DITA Adoption Meeting Agenda 010-06-2020 12:00PM/EST ==================================================== Stanley Doherty is inviting you to a scheduled Zoom meeting. Topic: OASIS DITA Adoption TC Time: Oct 6, 2020 12:00 PM Eastern Time (US and Canada) Every month on the First Tue, until Dec 1, 2020, 3 occurrence(s) Oct 6, 2020 12:00 PM Nov 3, 2020 12:00 PM Dec 1, 2020 12:00 PM Please download and import the following iCalendar (.ics) files to your calendar system. Monthly: https://us02web.zoom.us/meeting/tZUqdOyvqD4uHN0eMFCLqB5bxLTwcYZyVOAH/ics?icsToken=98tyKuGpqTgvHdKQtB-ORpwcB4jCZ-3wpiVbgo0NmTLDIAxCQFb0Ls52JbFGKsHm Join Zoom Meeting https://us02web.zoom.us/j/81735765469?pwd=OHVlaDVwYmp2UWd1UDU3ZkZGTVJVUT09 Meeting ID: 817 3576 5469 Passcode: Jamesons One tap mobile +19292056099,,81735765469#,,,,,,0#,,67051654# US (New York) +13017158592,,81735765469#,,,,,,0#,,67051654# US (Germantown) Dial by your location +1 929 205 6099 US (New York) +1 301 715 8592 US (Germantown) +1 312 626 6799 US (Chicago) +1 669 900 6833 US (San Jose) +1 253 215 8782 US (Tacoma) +1 346 248 7799 US (Houston) Meeting ID: 817 3576 5469 Passcode: 67051654 Find your local number: https://us02web.zoom.us/u/kcdY3wPL12 ===================================== TEAM ACTION ITEMS 01. Team: Add comments to the DITA User's Guide wiki, especially the section on tasks: > https://wiki.oasis-open.org/dita-adoption/DITA_User_Guide 02. Team: Brainstorm - How could we update our sample ATC whitepapers and samples -> DITA 2.0 and in so doing capture the upgrade costs and issues. 03. Team: Brainstorm - What would an initial list of whitepapers on DITA 2.0 subjects look like. > Example: Use intelligent key usage approach as an alternative to filtering > DITAVAL profiling (best practice). INDIVIDUAL ACTION ITEMS 01. Gershon: Update Word file on localization financials, convert to wiki, and post. 02. Scott: Review the updates to the wiki page and propose next steps for the DITA Users Guide. How do we make it happen? 03. Stan: Contact KrisE about current TC engagements with: a. PDF processor vendors 04. Stan and Scott: Contact Jarno about possible DITA-OT improvements suggested by user groups and listening session attendees. 05. Stan: Implement in our GIT repo the folder structure for whitepapers and sample docs. 06. Stan: Push CLI stylesheets files to repo. Inform team. 07. Stan: Push badging whitepaper sources to repo as they are ready. Inform team. 08. Kathy: Investigate other financial data about conversions. 09. Kathy: Ping WHP (Dominique Touche). Perhaps invite them to join us for a chat. 10. Kathy: Ditto for Kit Brown-Hoekstra (STC). 11. Kathy/Stan: Set up a meeting to look at stylesheet publishing through Framemaker. 12. Stan: Invite Carlos to join ATC for a meeting on supporting LwDITA. MEETING TOPICS 1. 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 2. 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. AI/Continue to review and add commnents to wiki. 3. 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 f. Tool vendors in support of RNG > DTDs??? 2.0 (once we drop XSD officially) Issues with RNG is implemented w/DITA 1.3. - ex. constraints and base elements - use case = <li> to contain only <p>; then need to reimplement base elements. - Norm Walsh - whitepaper? on RNG > DTD. DocBook. - AI/Gershon - looking into it, needs Oxygen. x. Demonstrable example - create a kit to reproduce the issue. Gershon. AI/Kathy ping Brianna on constraint issues with RNG files. <li> to contain only <p>. 4. Document review options (discussion) ??? > LwDITA implemented? 5. 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 furures. 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. 6. 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. 7. DITA 2.0 / LwDITA adoption planning Recap opportunities and action items form the meeting with Carlos last month. 8. DITA samples development a. DITA collections The CIDM article on sample DITA collections is at: > https://www.infomanagementcenter.com/dita-collections/ b. Stan: Build out some working content badging samples to support the writing in the badging whitepaper (Q3). > GitHub: https://github.com/StanDoherty/dita-badges 9. 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. 10. 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) d. Think about 2.0 docs e. Reach out to vendors as ATC for answering questions and testing. f. Updating ATC whitepapers and samples -> 2.0 will provide data on upgrade costs and issues. > Use intelligent key usage approach to filtering > DITAVAL profiling (best practice) > Potential whitepaper on keys > DITAVALs (Gerson?, Keith?) g. Probably have multiple whitepapers on 2.0 subjects. Line 'em up and knock 'em down.
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]