Re: same-named heading1s in different chapters ?

[Sean Brierley <sean -dot- brierley -at- gerbertechnology -dot- com>]

Try using gerunds for your headings. Is the heading text still the same in
both places?

On Tue, Dec 1, 2015 at 2:41 PM, Monique Semp <monique -dot- semp -at- earthlink -dot- net>
wrote:

> Hello, WR-L-ers,
>
> Iâve ended up with two chapters that both have a heading1, â<topic-name>â.
> It really is the correct name for both instances, within the context of
> their respective chapters.
>
> But somehow it just doesnât seem quite right to do this. (Iâve just added
> an xref in the first chapter to the same-named heading1 section in another
> chapter, which is what made me wonder about the wisdom of my chosen
> heading1 titles.) So I thought Iâd query the hive to find out your thoughts?
>
> I could see the answer varying depending on the delivery method. In this
> case itâs a FrameMaker-authored PDF doc. It will (never?) be delivered as
> HTML, so no chance of conflicting URL page names. And internal xrefs (which
> are live hyperlinks in the PDF) always have a page number included, so
> thereâs no chance of the user ending up in the wrong section.
>
> I could of course make the headings have longer text to provide context,
> but then for parallelism Iâd want to rename the other chaptersâ topics
> (which by chance do not repeat). The result would be excessive wordiness
> and a much harder to scan/comprehend ToC.
>
> Thoughts?
> -Monique
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot- 

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications?  Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions?  Search our public email archives @ http://techwr-l.com/archives