[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [dita] Index in the PDF version of the spec?
I think it is useful to provide a quality index for the specification. As such, I also agree with Bob below. I think prolog indexterms should apply to the entire scope of the topic, while inlines should also be used when necessary. Since a lot of the spec
has been broken into smaller components, I also hope it is true that we should be able to stick with the prolog approach in general. I do not want to rule out using the inline terms, though.
Thanks and best regards,
Scott Hudson
Senior Consultant
Comtech Services Inc.
303-232-7586
From: <dita@lists.oasis-open.org> on behalf of Bob Thomas
Date: Tuesday, July 7, 2015 at 8:31 AM To: Eliot Kimber Cc: DITA TC Subject: Re: [dita] Index in the PDF version of the spec? An index can be one of the better ways of finding things without having to take a drink out of the firehose that is search.
I agree with Eliot's position on inline vs. prolog. The only index terms in the prolog should be those that correspond with the entire scope of the topic. In general (i.e., not just the spec), writing shorter tightly scoped topics increases the likelihood that
index terms will be in the prolog rather than inline.
Best Regards,
Bob
On Tue, Jul 7, 2015 at 8:19 AM, Eliot Kimber
<ekimber@contrext.com> wrote:
I agree that an index is important. 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]