Link Logic: Difference between revisions

From Gerald R. Lucas
m (Corrected typo.)
m (→‎Make them Stand Out: Fixed typo.)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{nutshell|Links are the digital world’s citation method: they support what you say, grow your community, and represent the logic and interconnectivity of the digital world.}}
__NOTOC__{{nutshell|Links are the digital world’s citation method: they support what you say, grow your community, and represent the logic and interconnectivity of the digital world.}}


Just like an argument is incomplete without evidence to support it, all digital texts you create should include the citation method of the digital paradigm: the '''hyperlink''', or more commonly known as just '''the link'''.
Just like an argument is incomplete without evidence to support it, all digital texts you create should include the citation method of the digital paradigm: the '''hyperlink''', or more commonly known as just '''the link'''.
Line 5: Line 5:
The hyperlink has been around for decades, and according the Brian Carroll, links enhance a user’s comprehension of the material by providing a general sense of the important points on the page.<ref>{{cite book |last=Carroll |first=Brian |date=2017 |title=Writing & Editing for Digital Media |edition=3rd |url= |location=New York and London |publisher=Routledge |page=69 |isbn= |author-link= |ref=harv }}</ref> Links provide users' with options to dig deeper into the content, jump to a related page, or pursue another line of interest altogether. Links connect the pages of the internet in a non-linear fashion, so they should do so in a logical way. Therefore, '''linking should be practiced logically and consistently''', keeping the following guidelines in mind.
The hyperlink has been around for decades, and according the Brian Carroll, links enhance a user’s comprehension of the material by providing a general sense of the important points on the page.<ref>{{cite book |last=Carroll |first=Brian |date=2017 |title=Writing & Editing for Digital Media |edition=3rd |url= |location=New York and London |publisher=Routledge |page=69 |isbn= |author-link= |ref=harv }}</ref> Links provide users' with options to dig deeper into the content, jump to a related page, or pursue another line of interest altogether. Links connect the pages of the internet in a non-linear fashion, so they should do so in a logical way. Therefore, '''linking should be practiced logically and consistently''', keeping the following guidelines in mind.


==Make them Stand Out==
===Make them Stand Out===
{{Guides|expanded=advice}}
First and foremost, only link to pages with '''similar topics'''.<ref>{{cite book |last=Barr |first=Chris |date=2010 |title=The Yahoo! Style Guide |url= |location=St. Martins Press |publisher= |page=408 |isbn= |author-link= |ref=harv }}</ref> This guideline is especially important on sites like Wikipedia. Don’t just link to link, but be sure the links are relevant or that they clarify or expand the topic.
First and foremost, only link to pages with '''similar topics'''.<ref>{{cite book |last=Barr |first=Chris |date=2010 |title=The Yahoo! Style Guide |url= |location=St. Martins Press |publisher= |page=408 |isbn= |author-link= |ref=harv }}</ref> This guideline is especially important on sites like Wikipedia. Don’t just link to link, but be sure the links are relevant or that they clarify or expend the topic.


Links used to be underlined, but these days they are usually a different color from the text and often bolded. Whatever way they are displayed, they should '''stand out from the surrounding text''' and remain '''consistent''' throughout the document.{{sfn|Carroll|2017|p=71}} When working on a platform like Wikipedia, link appearance is already set.
Links used to be underlined, but these days they are usually a different color from the text and often bolded. Whatever way they are displayed, they should '''stand out from the surrounding text''' and remain '''consistent''' throughout the document.{{sfn|Carroll|2017|p=71}} When working on a platform like Wikipedia, link appearance is already set.


==Support Your Writing==
===Support Your Writing===
Especially in an academic context and on platforms like Wikipedia, the link should provide the '''primary way that you supply evidence''' for what you write. Links allow writers of digital media to lead users right to a source without interrupting the flow of the text.{{sfn|Carroll|2017|p=72}} You needn’t link every sentence, but your source, like in traditional research papers, should be evident by the context.
Especially in an academic context and on platforms like Wikipedia, the link should provide the '''primary way that you supply evidence''' for what you write. Links allow writers of digital media to lead users right to a source without interrupting the flow of the text.{{sfn|Carroll|2017|p=72}} You needn’t link every sentence, but your source, like in traditional research papers, should be evident by the context.


==Avoid Ugly URLs==
===Avoid Ugly URLs===
Never just paste in a URL when you can '''link actual English words'''. For example:
Never just paste in a URL when you can '''link actual English words'''. For example:


:Use Google (http://google.com/) to search.
{{quote|Use Google (http://google.com/) to search.}}


is correctly presented:
is correctly presented:


:Use [http://google.com/ Google] to search.
{{quote|Use [http://google.com/ Google] to search.}}


Most platforms have easy, elegant ways to insert links.
Most platforms have easy, elegant ways to insert links.


==Avoid Directions==
===Avoid Directions===
Back when the World Wide Web was young, the link was a foreign idea. Users surfing for the first time didn’t necessarily know what a link was or what one was supposed to do with it. In order to explain the link, an action was often built-in. We’ve all seen:
Back when the World Wide Web was young, the link was a foreign idea. Users surfing for the first time didn’t necessarily know what a link was or what one was supposed to do with it. In order to explain the link, an action was often built-in. We’ve all seen:


:To access this document, click here.
{{quote|To access this document, click here.}}


Arguably, this has always been awkward, but somewhat understandable. However, now that the use of links has become normalized, we no longer need to give instructions about what to do nor where to do it. Avoid any mention of “click” and “here,” unless you want to make your users feel dumb. Not only that, but “click here” gives users no indication where the link will take them.{{sfn|Barr|2010|p=123}} In fact, using “here” actually hides what users are clicking, makes the text wordy and awkward, and, according to Chris Barr, misses an opportunity to optimize your page for search engines.{{sfn|Barr|2010|p=408}}
Arguably, this has always been awkward, but somewhat understandable. However, now that the use of links has become normalized, we no longer need to give instructions about what to do nor where to do it. Avoid any mention of “click” and “here,” unless you want to make your users feel dumb. Not only that, but “click here” gives users no indication where the link will take them.{{sfn|Barr|2010|p=123}} In fact, using “here” actually hides what users are clicking, makes the text wordy and awkward, and, according to Chris Barr, misses an opportunity to optimize your page for search engines.{{sfn|Barr|2010|p=408}}


==Link Specific Nouns==
===Link Specific Nouns===
Links should be intuitive, short, descriptive text about where the link goes.{{sfn|Barr|2010|p=123}} That is, users should know exactly where a link will land them.{{sfn|Carroll|2017|p=71}} In other words, links tell users and search engines what the page being linked to is all about.{{sfn|Barr|2010|p=407}} Link only key words: or '''the most specific noun of the sentence''' — the one that most accurately communicates the content of the link.{{sfn|Carroll|2017|p=73}} Proper nouns are often the best choice for links as they are unique and unambiguous.
Links should be intuitive, short, descriptive text about where the link goes.{{sfn|Barr|2010|p=123}} That is, users should know exactly where a link will land them.{{sfn|Carroll|2017|p=71}} In other words, links tell users and search engines what the page being linked to is all about.{{sfn|Barr|2010|p=407}} Link only key words: or '''the most specific noun of the sentence''' — the one that most accurately communicates the content of the link.{{sfn|Carroll|2017|p=73}} Proper nouns are often the best choice for links as they are unique and unambiguous.


For example, if you’re linking to a book, use the title, not the word “book”:
For example, if you’re linking to a book, use the title, not the word “book”:


:For a discussion of implementing these ideas, see Nicholas Negroponte’s [https://archive.org/details/beingdigital00negr ''Being Digital''].
{{quote|For a discussion of implementing these ideas, see Nicholas Negroponte’s [https://archive.org/details/beingdigital00negr ''Being Digital''].}}


Since the [[Writing in the Liberal Arts|title of the book is italicized]], users understand it’s a book already. Logically, the link would take users to a page where they could find more information on ''Being Digital''. Ending a sentence on a link will also highlight it. Notice, too, the final punctuation '''is not''' linked.{{sfn|Barr|2010|p=127}} Avoid linking too many words in a row.
Since the [[Writing in the Liberal Arts|title of the book is italicized]], users understand it’s a book already. Logically, the link would take users to a page where they could find more information on ''Being Digital''. Ending a sentence on a link will also highlight it. Notice, too, the final punctuation '''is not''' linked.{{sfn|Barr|2010|p=127}} Avoid linking too many words in a row.
Line 45: Line 44:
Keep links concise by only linking a couple of words — never a whole sentence. If the link falls in the middle of a sentence, use ''sentence case'' when linking; i.e. use lowercase like you would any other words of the sentence unless the link happens to be a title.{{sfn|Barr|2010|p=127}}
Keep links concise by only linking a couple of words — never a whole sentence. If the link falls in the middle of a sentence, use ''sentence case'' when linking; i.e. use lowercase like you would any other words of the sentence unless the link happens to be a title.{{sfn|Barr|2010|p=127}}


==Link Once==
===Link Once===
Sources should be '''linked only once''' on a single page. For example, if Negroponte’s book above was referred to again on the same post, linking would be redundant. In other words: '''link only the first occurrence of the reference'''.
Sources should be '''linked only once''' on a single page. For example, if Negroponte’s book above was referred to again on the same post, linking would be redundant. In other words: '''link only the first occurrence of the reference'''.


==Give Links a Context==
===Give Links a Context===
Never just ambiguously link nouns in a sentence; for example:
Never just ambiguously link nouns in a sentence; for example:


:I often used to travel to [https://blog.wikimedia.de/en/ Germany] for work.
{{quote|I often used to travel to [https://blog.wikimedia.de/en/ Germany] for work.}}


With this link, users have no idea where following it might lead. Does it go to a Wikipedia entry, an essay about bratwurst, a review of Oktoberfest in Munich, or a Lonely Planet travel guide? The only way to find out is to click, potentially wasting users’ time. Instead, be specific about where the link will land:
With this link, users have no idea where following it might lead. Does it go to a Wikipedia entry, an essay about bratwurst, a review of Oktoberfest in Munich, or a Lonely Planet travel guide? The only way to find out is to click, potentially wasting users’ time. Instead, be specific about where the link will land:


:I often used to travel to Germany for work, as I detail in my [https://blog.wikimedia.de/en/ Work Deutschland blog].
{{quote|I often used to travel to Germany for work, as I detail in my [https://blog.wikimedia.de/en/ Work Deutschland blog].}}


Similarly, never just point to a link:
Similarly, never just point to a link:


:Betty Harnett discusses spelunking [[Link Logic|in her article]].
{{quote|Betty Harnett discusses spelunking [[Link Logic|in her article]].}}


This might be true, but give a users a bit more of a reason to check out Harnett’s article:
This might be true, but give a users a bit more of a reason to check out Harnett’s article:


:For an exciting account of spelunking in the 100-mile Mexican cave, see Betty Harnett’s “[[Link Logic|The Great Mexican Cave Dive]].”
{{quote|For an exciting account of spelunking in the 100-mile Mexican cave, see Betty Harnett’s “[[Link Logic|The Great Mexican Cave Dive]].”}}


When linking, consider this overall guideline: '''always sell your links to your users with specific details'''.
When linking, consider this overall guideline: '''always sell your links to your users with specific details'''.
Line 69: Line 68:
{{notice|For linking using HTML, see “[[Basic HTML]].” For more about citing sources in digital documents, see “[[Digital Citation]].” For linking on Wikipedia, see “[[Writing on a Wiki]]”.}}
{{notice|For linking using HTML, see “[[Basic HTML]].” For more about citing sources in digital documents, see “[[Digital Citation]].” For linking on Wikipedia, see “[[Writing on a Wiki]]”.}}


==References==
{{Notes}}
{{Reflist}}
 
{{Students}}
[[Category:Student Resources]]
[[Category:Composition]]

Latest revision as of 07:46, 8 September 2023

Just like an argument is incomplete without evidence to support it, all digital texts you create should include the citation method of the digital paradigm: the hyperlink, or more commonly known as just the link.

Links.jpg

The hyperlink has been around for decades, and according the Brian Carroll, links enhance a user’s comprehension of the material by providing a general sense of the important points on the page.[1] Links provide users' with options to dig deeper into the content, jump to a related page, or pursue another line of interest altogether. Links connect the pages of the internet in a non-linear fashion, so they should do so in a logical way. Therefore, linking should be practiced logically and consistently, keeping the following guidelines in mind.

Make them Stand Out

First and foremost, only link to pages with similar topics.[2] This guideline is especially important on sites like Wikipedia. Don’t just link to link, but be sure the links are relevant or that they clarify or expand the topic.

Links used to be underlined, but these days they are usually a different color from the text and often bolded. Whatever way they are displayed, they should stand out from the surrounding text and remain consistent throughout the document.[3] When working on a platform like Wikipedia, link appearance is already set.

Support Your Writing

Especially in an academic context and on platforms like Wikipedia, the link should provide the primary way that you supply evidence for what you write. Links allow writers of digital media to lead users right to a source without interrupting the flow of the text.[4] You needn’t link every sentence, but your source, like in traditional research papers, should be evident by the context.

Avoid Ugly URLs

Never just paste in a URL when you can link actual English words. For example:

Use Google (http://google.com/) to search.

is correctly presented:

Use Google to search.

Most platforms have easy, elegant ways to insert links.

Avoid Directions

Back when the World Wide Web was young, the link was a foreign idea. Users surfing for the first time didn’t necessarily know what a link was or what one was supposed to do with it. In order to explain the link, an action was often built-in. We’ve all seen:

To access this document, click here.

Arguably, this has always been awkward, but somewhat understandable. However, now that the use of links has become normalized, we no longer need to give instructions about what to do nor where to do it. Avoid any mention of “click” and “here,” unless you want to make your users feel dumb. Not only that, but “click here” gives users no indication where the link will take them.[5] In fact, using “here” actually hides what users are clicking, makes the text wordy and awkward, and, according to Chris Barr, misses an opportunity to optimize your page for search engines.[6]

Link Specific Nouns

Links should be intuitive, short, descriptive text about where the link goes.[5] That is, users should know exactly where a link will land them.[3] In other words, links tell users and search engines what the page being linked to is all about.[7] Link only key words: or the most specific noun of the sentence — the one that most accurately communicates the content of the link.[8] Proper nouns are often the best choice for links as they are unique and unambiguous.

For example, if you’re linking to a book, use the title, not the word “book”:

For a discussion of implementing these ideas, see Nicholas Negroponte’s Being Digital.

Since the title of the book is italicized, users understand it’s a book already. Logically, the link would take users to a page where they could find more information on Being Digital. Ending a sentence on a link will also highlight it. Notice, too, the final punctuation is not linked.[9] Avoid linking too many words in a row.

If the platform allows it, always link English words. Avoid pasting ugly URLs when possible. If for some reason a URL is necessary, try a service like Bitly that will shorten them.

Keep links concise by only linking a couple of words — never a whole sentence. If the link falls in the middle of a sentence, use sentence case when linking; i.e. use lowercase like you would any other words of the sentence unless the link happens to be a title.[9]

Link Once

Sources should be linked only once on a single page. For example, if Negroponte’s book above was referred to again on the same post, linking would be redundant. In other words: link only the first occurrence of the reference.

Give Links a Context

Never just ambiguously link nouns in a sentence; for example:

I often used to travel to Germany for work.

With this link, users have no idea where following it might lead. Does it go to a Wikipedia entry, an essay about bratwurst, a review of Oktoberfest in Munich, or a Lonely Planet travel guide? The only way to find out is to click, potentially wasting users’ time. Instead, be specific about where the link will land:

I often used to travel to Germany for work, as I detail in my Work Deutschland blog.

Similarly, never just point to a link:

Betty Harnett discusses spelunking in her article.

This might be true, but give a users a bit more of a reason to check out Harnett’s article:

For an exciting account of spelunking in the 100-mile Mexican cave, see Betty Harnett’s “The Great Mexican Cave Dive.”

When linking, consider this overall guideline: always sell your links to your users with specific details.



notes

  1. Carroll, Brian (2017). Writing & Editing for Digital Media (3rd ed.). New York and London: Routledge. p. 69.
  2. Barr, Chris (2010). The Yahoo! Style Guide. St. Martins Press. p. 408.
  3. 3.0 3.1 Carroll 2017, p. 71.
  4. Carroll 2017, p. 72.
  5. 5.0 5.1 Barr 2010, p. 123.
  6. Barr 2010, p. 408.
  7. Barr 2010, p. 407.
  8. Carroll 2017, p. 73.
  9. 9.0 9.1 Barr 2010, p. 127.