TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
I cannot believe you can logically have the same title on two chapters that
cover different topics. What are the differences in the content in those
chapters?
On Tue, Dec 1, 2015 at 1: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 bus -dot- write -at- gmail -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
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com