Re: [dita-lightweight-dita] Draft of LwDITA Committee Note 2.0

Here are some of my comments, just to get the ball-of-discussion rolling:

- Possibly silly question, but do these changes/updates warrant moving from "1.0" to "2.0"? From what I am seeing am thinking a "1.1" or "1.5" since this doesn't seem to be a sea-change over what went before

4.4
"This design simplifies the authoring experience, as there are no choices to be made."
- The phrase "there are no choices" is awkward; suggest instead something like: "as the number of available options in DITA 1.3 have been simplified to a single choice."

5.3.2
- Am guessing that all of these additional information structures available in MDITA are simply things we had missed? In other words, the functionality was there already in Markdown, and we simply hadn't noted it before?

5.4
"With a combination of formats that includes the MDITA extended profile, authors can even use content referencing and key referencing."
- An awkward construction. I think you mean more simply: "Authors can use content referencing ("conrefs") and key referencing ("keys"), using any flavor of LwDITA with the exception of MDITA core."

6.
- As a humble suggestion, could we add a new sub-section here that links to the LwDITA code samples I have cobbled together on GitHub? For that matter I think it is also worth mentioning that sample code exists alongside this Committee Note.

- in general I think it would be worthwhile to expand the sample code sections where they appear (it may just be me, but the more example code the better)

Appendix A.1
- Am just wondering if it might make more sense to have a separate column for MDITA core and MDITA extended instead of having to thrown in all of the explanations and exceptions into one column. I think it might make things clearer.
- Also, could we use the same monospaced font, code-phrase formatting for the code that appears under the MDITA column?

Terrific work on this Carlos!

Cheers!

Keith Schengili-Roberts

Market Researcher and DITA Evangelist

IXIASOFT

825 Querbes, Suite 200, Montréal, Québec, Canada, H2V 3X1

tel + 1 514 279-4942 / toll free + 1 877 279-4942

robertsk@ixiasoft.com / www.ixiasoft.com

dita-lightweight-dita message