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.
It seems the reason to use for more information about x, see y construction is if you are presenting a list of links. Otherwise it probably isnât necessary to include the âabout x â piece.
> On Dec 27, 2018, at 3:36 PM, Lauren <lauren -at- writeco -dot- net> wrote:
>
> 25 years ago, when I had my introduction to technical writing in a technical writing course, I learned to avoid the "to be" sense and wound-up applying that to nearly every use of the word "to" and the future tense. Whether my instructor was right or wrong, the habit remained. I also look for ways to say things with the fewest words possible that convey all of the necessary information, like avoiding unnecessary repetition.
>
> Is it important for you to repeat "A." If "A" is a long title, will the duplicity help or hinder?
>
> Here, you can delete the word "to" and then fix your sentence. For example, "Learn more [at] A" or "See [A]" and leave out everything else.
>
> Here are my examples with your examples for comparison using this link represented by brackets: https://constitutioncenter.org/interactive-constitution.
>
> A: To learn more about The Constitution of the United States of America, see [The Constitution of the United States of America].
>
> B: See [The Constitution of the United States of America] to learn more about The Constitution of the United States of America.
>
> C: Learn more about [The Constitution of the United States of America].
>
> D: See [The Constitution of the United States of America].
>
> Perhaps you may want something that says "follow" [or click] this link." People are internet savvy now and can usually recognize that linked text provides more information about the text and do not need to be reminded to follow the link or that by following the link they will "learn more."
>
> There are example of "See [link]" here, https://grammar.collinsdictionary.com/us/easy-learning/future-reference. Although many references on that page are self-referencing. Minor error...
>
>
>> On 12/27/2018 4:46 AM, Paul Hanson wrote:
>> I'm looking for a source to use in a style guide. Given these two options:
>> |
>> Option A: To learn more about A, see <hyperlink>A</hyperlink>.
>> Option B: See <hyperlink>A</hyperlink> to learn more about A.
>> |
>> I want to specify that Option A is the preferred sentence structure for the following reasons:
>> 1) it doesn't make the reader choose whether to click the hyperlink or finish the sentence.
>> 2) if the reader does finish the sentence, the eyes have to go back 5 words in order to click the hyperlink.
>>
>> I can't remember where I read about this. It might have been mentioned in a WritersUA session or stated on this list - if *you* know and think, "Duh Hanson, it's in [source]" please tell me...
>
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Visit TechWhirl for the latest on content technology, content strategy and content development | https://techwhirl.com
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as sharipunyon -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 | https://techwhirl.com
