[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
Sure, I'd be willing to help maintain. My github ID is shudson310.
Thanks and best regards,
--Scott
Scott Hudson
Content Technology Strategist, DS&A Information and Knowledge Services
OASIS Standards focal for The Boeing Company, Boeing Data Standards Technical Advisory Board member
Jeppesen, A Boeing Company
55 Inverness Drive East
Englewood, CO 80112
303-328-6228 | Cell: 303-350-7934
http://www.jeppesen.com <http://www.jeppesen.com/>
ïOn 4/6/20, 8:01 AM, "dita-adoption@lists.oasis-open.org on behalf of keith@ditawriter.com" <dita-adoption@lists.oasis-open.org on behalf of keith@ditawriter.com> wrote:
Chet beat me to it! I am actually in the middle of filling in the
necessary forms for creating the GitHub repositories now.
And as Chet says below, I need the GitHub ID from a member (or two)
from the group to make the application (I can take care of the other
details). Could one or two people to volunteer to help be a
co-maintainer of the GitHub repositories being set up?
Cheers!
Quoting Chet Ensign <chet.ensign@oasis-open.org>:
> Happy Monday everyone,
>
> Just jumping in with some answers to items in your minutes...
>
> On Sat, Apr 4, 2020 at 5:21 PM Dr. Stanley Doherty <stan@modularwriting.com>
> wrote:
>
>>
>> INDIVIDUAL ACTION ITEMS
>> 1. Keith: Request of Scott McGrath that DITA Adoption have BOTH an
>> open source (public) and ATC-only Git repo.
>>
> You request these using
> https://urldefense.proofpoint.com/v2/url?u=https-3A__www.oasis-2Dopen.org_resources_tc-2Dadmin-2Drequests_open-2Drepository-2Drequest&d=DwIBaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=wpdi7tSBPJoySuVw43tXqiizvhwWCULCQ4uZxggtFIs&s=hGQJOJQBA6ACUG8fupQMJf0LpQmveZV_7IdiSktgR8w&e=
> and
> https://urldefense.proofpoint.com/v2/url?u=https-3A__www.oasis-2Dopen.org_resources_tc-2Dadmin-2Drequests_request-2Da-2Dtc-2Dgithub-2Dversion-2Dcontrol-2Dinstance-2Dbe-2Dcreated&d=DwIBaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=wpdi7tSBPJoySuVw43tXqiizvhwWCULCQ4uZxggtFIs&s=gRq4QyOoQPEd0rholDYdaVhh8df3KaY8ZJn8wgoq99k&e= .
> For each, you will need a name for the repo, a one-sentence description, a
> statement of purpose, and the names, email addresses, and GitHub ids for
> the people who will be the maintainers.
>
>
>> 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.
>>
> Thanks. I will take care of this.
>
>
>> 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://urldefense.proofpoint.com/v2/url?u=https-3A__wiki.oasis-2Dopen.org_dita-2Dadoption_DITA-5FUser-5FGuide&d=DwIBaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=wpdi7tSBPJoySuVw43tXqiizvhwWCULCQ4uZxggtFIs&s=cLYD3fkW4hIK9Vv_xy3xi8Q2_Ud6-TNXTub_GEd6RpA&e=
>> 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://urldefense.proofpoint.com/v2/url?u=https-3A__www.oasis-2Dopen.org_apps_org_workgroup_dita-2Dadoption_download.php_66664_bookmap-5Fatc-5Finstall-2Dtc-2Dstylesheets.pdf&d=DwIBaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=wpdi7tSBPJoySuVw43tXqiizvhwWCULCQ4uZxggtFIs&s=H_tOFiTEBxLH8y6hLRk0hmPouiqtbe4-XtFO0mgq_Vo&e=
>> > Sources:
>> https://urldefense.proofpoint.com/v2/url?u=https-3A__www.oasis-2Dopen.org_apps_org_workgroup_dita-2Dadoption_download.php_66663_atc-5Finstall-2Dtc-2Dstylesheets-5F02.zip&d=DwIBaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=wpdi7tSBPJoySuVw43tXqiizvhwWCULCQ4uZxggtFIs&s=eNCVJaj1WKIlsm6eeD45xPZKliSVHVKGgtVbh7TdvgY&e=
>> 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://urldefense.proofpoint.com/v2/url?u=https-3A__wiki.oasis-2Dopen.org_dita-2Dadoption_ditaconversionchecklist-23preview&d=DwIBaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=wpdi7tSBPJoySuVw43tXqiizvhwWCULCQ4uZxggtFIs&s=IhsWkTgLuzsQMFdIZXEsLofSoD9Day4SebMKFr9XKyc&e=
>> > 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://urldefense.proofpoint.com/v2/url?u=https-3A__dita.xml.org_&d=DwIBaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=wpdi7tSBPJoySuVw43tXqiizvhwWCULCQ4uZxggtFIs&s=Y8x1-bQMpzo_C5k4amOz48RMBpMxFkCjn2naKcwNoHc&e= 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://urldefense.proofpoint.com/v2/url?u=https-3A__www.infomanagementcenter.com_dita-2Dcollections_&d=DwIBaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=wpdi7tSBPJoySuVw43tXqiizvhwWCULCQ4uZxggtFIs&s=-IypO0haKiPB9Bq1Krsh9_qT0DcT-YT5OzvqrKqRHWA&e=
>> 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://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_StanDoherty_dita-2Dbadges&d=DwIBaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=wpdi7tSBPJoySuVw43tXqiizvhwWCULCQ4uZxggtFIs&s=j-pRzAiqrfk8gLu5z7wQeaM-Xx-d6AM_Uo3YBSqrbEs&e=
>>
>> 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
>>
>>
>
> --
>
> /chet
> ----------------
> Chet Ensign
> Chief Technical Community Steward
> OASIS: Advancing open source & open standards for the information society
> https://urldefense.proofpoint.com/v2/url?u=http-3A__www.oasis-2Dopen.org&d=DwIBaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=wpdi7tSBPJoySuVw43tXqiizvhwWCULCQ4uZxggtFIs&s=PeAsRdY1GJVLiUaBR3ViPKJY7TBufAkm8boeU8aA3kc&e=
>
> Mobile: +1 201-341-1393
---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail. Follow this link to all your TCs in OASIS at:
https://urldefense.proofpoint.com/v2/url?u=https-3A__www.oasis-2Dopen.org_apps_org_workgroup_portal_my-5Fworkgroups.php&d=DwIBaQ&c=P3aKjizb3qsxp0SERaL2sw&r=YQWdLfM9mekBOdoMmoBdn9RgyqIHrveGolBbb4_uGWQ&m=wpdi7tSBPJoySuVw43tXqiizvhwWCULCQ4uZxggtFIs&s=ZqfwOSvY7X55Ugcfo8EIjbajV6wwkVl2TKJUrQKxA6A&e=
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]