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, "2.5.4.1 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)
On 5/29/2015 4:53 PM, Hudson, Scott
wrote:
Hi Bob, et al,
I noticed the following issues in the PDF, which may be
content or rendering issues:
Pg 37 xref for See @deliveryTarget not active: @print
Specifies whether the topic should be included in printed
output. Note: Beginning with DITA 1.3, the @print attribute is
deprecated. It is replaced with a conditional processing
attribute: @deliveryTarget. See @deliveryTarget for more
details.
<kje>This is a conref to a
<dlentry>.</kje>
Pg 47 Alignment on last cell of row 3 (Excluded)
<kje>Removed a @char attribute. Had to
look up what the @char attribute does.</kje>
Pg 56 Odd xref for 2 and 5. Is this intended? Should this
be labeled step 2 or step 5 or something?
<kje>Added the word "item" before the
<xref>. Bob, is there a way that we can suppress the
auto-generated text "on page" when the cross reference is to
something on the same page?</kje>
Pg 91 referenced element and referencing element appear to
be links, but not active. If this is formatting for terms,
they either need to be active (if blue color), or we should
change the formatting to black bold italic or something. It is
confusing to users if something appears to be a traversable
link, but is not.
<kje>This is a conref to a
<dlentry>.</kje>
Pg 159 more inactive links: Module inclusions, Content
constraint integration
<kje>This is a conref to a
<dlentry>.</kje>
Pg 185, 186, 187, 190… (seems true for all instances in
doc) inactive link: outputclass
<kje>This is a conref to a
<dlentry>.</kje>
Pg 236 inactive link (may be intentional, but how do we
want to handle deprecated content?) query (DEPRECATED)
<kje>This is a conref to a
<dlentry>.</kje>
Pg 237 inactive link: spectitle, mapkeyref, collection-type
<kje>This is a conref to a
<dlentry>.</kje>
Pg 392 Footnote word is wrapped oddly. Shouldn’t it have
the number of the footnote it refers to, instead of the text
“Footnote”?
<kje>Leaving this to Robert. He's the
only person brave enough to work in this topic.</kje>
Pg 402 bullet alignment in row 2, col 3. If sub-bullets,
they should be a different character.
<kje>We currently do not use different
characters for different levels of lists. I'd mark this as a
nicety that we can consider once the pressing items are fixed.</kje>
Pg 409 (Appendix C) the “on page" numbers is pretty
horrible from a usability perspective. It makes it so you
can’t read the content model. Not sure how to fix this, but I
think it will be an issue.
<kje>It would be good to change the way
<xref> to topics are rendered here in the content model
appendix. Not sure whether the best way to do that is modify the
markup in the topics (which are generated) or to change the style
sheets. Bob, maybe you and I and Robert can talk about this.</kje>
Thanks and best regards,
Scott Hudson
Senior Consultant
Comtech Services Inc.
303-232-7586
Submitter's message
More fixes
-- Mr. Robert Thomas
|