OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [dita] Groups - Sample PDF uploaded

Here are a few thoughts on the Content Model Appendix:

Since the schemas themselves are part of the standard, is it necessary to include this appendix in the specification at all?

It's useful information, but couldn't it be a non-normative, HTML-only, appendix? That would let you remove the page numbers, which would make the content models more readable. I would also suggest removing the brackets on the element names in this section, since they're not needed to avoid ambiguity in this context.

If you decide to keep this appendix in the PDF version of the spec, I would still remove the page number references (the whole section is in alphabetical order) and also remove the brackets. However, I would keep the page number references in the text at the top of each block (the text that reads: "Content models for <element name> on page XXX"). It would be nice, but not essential, to have a header on each page with the element names (like dictionaries have) so it would be easier to locate a particular element in the appendix.

Regarding the same appendix, why do you use the term "containment model"? I don't see a distinction between containment model and content model in this context. And I see no reference to containment model anywhere else in the spec (just a couple of passing references to "containment hierarchy").

Best regards,
XML Press
XML for Technical Communicators

On May 30, 2015, at 5:22, Kristen James Eberlein <kris@eberleinconsulting.com> wrote:

> I am going to add some contents here, since I am familiar with the content. (And am procrastinating on cleaning my house before my cleaning lady arrives.)
> Folks, when you provide feedback on the spec formatting, please be sure and include not just the page number, but also the number and title of the topic. For example, " RELAX NG document-type shell: Coding requirements".
> Bob, here's my quick summary; almost everything concerns cross references:
> 	• Cross references to <dlentry> elements are not being rendered as links. That happens out-of-the-box with HTML output, and I think Robert and I had forgotten that the PDF style sheets would need to be tweaked to accomplish that.
> 	• Including the auto-generated text "on page" for <xref> to topics in the content model appendix just does not work. Let's you and I and Robert put our heads together about this one.
> 	• Is there a way to suppress the auto-generated text "on page" when the cross reference is to something that will be rendered on the same PDF page?
> 	• We lack styling for the different levels of an unordered list, except for indentaton. (Lower priority)
> 	• Regarding the item on page 392, I'm leaving that one to Robert. (I'm not brave enough to venture into that topic.)
> Best,
> Kris
> Kristen James Eberlein
> Chair, OASIS DITA Technical Committee
> Principal consultant, Eberlein Consulting
> www.eberleinconsulting.com
> +1 919 682-2290; kriseberlein (skype)

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]