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


I agree. I'll create a new checklist on the Trello card to track this.


On Sat, May 30, 2015 at 6:22 AM, 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.)


Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
+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.

From: <dita@lists.oasis-open.org> on behalf of Robert Thomas
Date: Friday, May 29, 2015 at 2:15 PM
To: "dita@lists.oasis-open.org"
Subject: [dita] Groups - Sample PDF uploaded

Submitter's message
More fixes
-- Mr. Robert Thomas
Document Name: Sample PDF

No description provided.
Download Latest Revision
Public Download Link

Submitter: Mr. Robert Thomas
Group: OASIS Darwin Information Typing Architecture (DITA) TC
Folder: Support materials
Date submitted: 2015-05-29 13:15:22
Revision: 1

--------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php

Bob Thomas
+1 720 201 8260
Skype: bob.thomas.colorado
Instant messaging: Gmail chat (bob.thomas@tagsmiths.com) or Skype
Time zone: Mountain (GMT-7)

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