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.
A well-titled article/link would likely establish context and enable action
without requiring reading what is likely duplicate information before you
can click.
My 2 cents ...
JG
On Dec 27, 2018 8:33 AM, "Tony Chung" <tonyc -at- tonychung -dot- ca> wrote:
Hi Paul,
âContext before actionâ is always preferred. Even when I experiment with
other methods I always return to context first.
Google finds some resources, but this is most clear (albeit devoid of
persuasive argumentation):
On Thu, Dec 27, 2018 at 05:23 Paul Hanson <twer_lists_all -at- hotmail -dot- com>
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...
>
> Thank you.
>
> Paul Hanson
> My blog: http://prhmusic.blogspot.com<http://prhmusic.blogspot.com/>
> My Favorite Band is coming to Town Soon: Counting Down the 100 Days until
> the Bayside Concert at Gabes Oasis on 1/30/2019!<
>https://prhmusic.blogspot.com/p/blog-page_22.html>
> Me Playing Drums:
>http://prhmusic.blogspot.com/p/videos-of-me-playing-drums.html
> Twitter: @prhmusic
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Visit TechWhirl for the latest on content technology, content strategy and
> content development | https://techwhirl.com
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as tonyc -at- tonychung -dot- ca -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
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
