Lightweight DITA
23 Feb 2015
Assignment of minutes: Scott Hudson
Roll call:
Michael Priestly
Don Day
Carlos Evia
Mark Giffin
Scott Hudson
Joe Pairman
John Hunt
Roundtable:
Medical - not present
Education - working on the personas
Software - Michael pulling together straw man of
Marketing - Noz Urbina to form/lead, Michael to set up kickoff
Machine Industry - Michael setting up meeting w/Jan, Sissi
Discussion:
Markdown - Jarno published updated plugin and including additional functionality for sections. Carlos has been working on a demo. At one point, DITA Publishers had a mapping to json (generate json using DITA). Bertrand was working on it?
Markdown demo: http://carlosevia.github.io
Use case: Develop content in Markdown and export to DITA for inclusion in an existing DITA doc set.
Anything at H2 level will become a nested topic. You must explicitly define a section for the section to be created. Why use this instead of pandoc or jekyl? Would be nice to be able to roundtrip, so content could be used in Swagger or other tool (Slate?)
You must use a dita map, and the first topic cannot be markdown.
Carlos to work on some additional mappings.
Don Day - put together a wiki page scraper that will output DITA. any2dita.com source on github.com/donrday
create dita from other formats to convert and put in an existing repository
want to add hdita mode.
FYI: Download results fairly quickly, as housekeeping will clean it out after about 2 hours!
dita.xml.org has a blog post (search for hdita ) regarding mappings.
Carlos looking for articles claiming that “DITA has too many tags”.
One of the major issues with the DITA spec is with the number of examples and content model listings. (appearance of complexity due to the “page count” of the spec)
Measurement: A DITA topic without additional domains is actually a smaller content model than HTML!
Should the SC provide formal feedback to Jarno for his work on Markdown?
Nested topics is perfectly valid DITA, so that is good.
Not try to enable everything that Tech Comm needs, but more from what web content providers need.
medium.com authoring interface is extremely simple. Designed for narrative text, but a good example of what we should focus on to support the authoring experience.
“Author Experience”
Next meeting: 2 weeks from today
Thanks and best regards,
Scott Hudson
Senior Consultant
Comtech Services Inc.
710 Kipling Street, Suite 400
Denver, CO 80215
303-232-7586
CIDM will be hosting the Content Management Strategies/DITA North America 2015 conference in Chicago, Illinois April 20-22, 2015. More information at: