Technical Advisory Board (TAB)

 View Only

Great call with Kristen James Eberlein - DITA TC

  • 1.  Great call with Kristen James Eberlein - DITA TC

    Posted 09-24-2015 20:07
    Greetings! I had a great call this afternoon with Kristen James Eberlein, Chair of the DITA TC today. You may want to open up https://issues.oasis-open.org/browse/TAB-1282 to follow along. Part of the DITA 1.3 release reads: ***** 2.2 DITA markup Topics and maps are the basic building blocks of the Darwin Information Typing Architecture (DITA). Metadata attributes and values can be added to DITA topics and maps, as well as to elements within topics, to allow for conditional publishing and content reuse. DITA topics and maps are XML documents that conform to the XML specification. As such, they can be viewed, edited, validated, and processed with standard XML tools, although some DITA-specific features, such as content reference, key reference, and specialization require DITA-specific processing for full implementation and validation. 2.2.1 DITA topics DITA topics are the basic units of DITA content and the basic units of reuse. Each topic contains a single subject. Topics may be of specific specialized information types, such as task, concept, or reference, or may be generic, that is, without a specified information type. ***** Which I commented on as "hanging paragraphs." Turns out those are *not* hanging paragraphs, at least not in the ISO sense. In DITA, 2.2 DITA markup is a topic and the only information reported for that topic are the two paragraphs that follow it. 2.2.1 DITA topics is related (actually a child as well) but is independent of the topic, 2.2 DITA markup. Seen as independent topics with independent content and not the clause/sub-clause structure of ISO documents, this is not a case of hanging paragraphs. I thought I had better write this down before I sleep tonight and lose this insight. Which I gained only thanks to Kris! NOTE: This does not apply to TCs outside of DITA with poor structuring of their documents. ;-) I have copied Kris with this post just in case my report of our conversation is confusing or incorrect. Hope everyone is having a great week! Patrick -- Patrick Durusau patrick@durusau.net Technical Advisory Board, OASIS (TAB) OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300 Co-Editor 13250-5 (Topic Maps) Another Word For It (blog): http://tm.durusau.net Homepage: http://www.durusau.net Twitter: patrickDurusau