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.
Re: [BULK] Re: Use of word "reference" when cross referencing
Subject:Re: [BULK] Re: Use of word "reference" when cross referencing From:Robert Lauriston <robert -at- lauriston -dot- com> To:TECHWR-L Writing <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Wed, 15 Aug 2018 13:36:34 -0700
The Microsoft Manual of Style, 4th Edition, is a book written and
edited by Microsoft Press staff. It's well-organized, has some useful
illustrations, and was professionally laid out in InDesign, so the PDF
was first-rate.
The Microsoft Style Guide is a GitHub project started by three
Microsoft engineers and a marketing writer. The original content was a
subset of what was in the book with topics that were previously
grouped logically put into alphabetical order. iTextSharp is a free
tool they use to dump the web site to that crude PDF.
When they first started, the cross-references pointed to the web site
rather than to targets in the book.
On Wed, Aug 15, 2018 at 1:25 PM, Lauren <lauren -at- writeco -dot- net> wrote:
> On 8/15/2018 1:17 PM, Robert Lauriston wrote:
>>
>> That's an iTextSharp dump of the Microsoft Style Guide web site.
>
>
> What is that? How is this book different from the one you purchase?
>
>> They've improved it a bit, the cross-references work now instead of
>> sending you back to the web site.
>
>
> I didn't see cross-references going to the website in the pdf. Every link
> goes to the information that is referenced. Every reference is preceded by
> "See also," incidentally.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com
