FamilySearch Wiki:Manual of Style: Difference between revisions

FamilySearch Wiki:Manual of Style (view source)

Revision as of 15:30, 2 February 2010

975 bytes added , 2 February 2010

smithing

VisualWikitext

RitcheyMT

4,497

edits

@@ Line 57: / Line 57: @@
 === Linking to other Websites ===
-==== Links should not include full URL ====
+=== Links should not display the full URL  ===
-For readability's sake, links should not include the full URL of the destination page. There may be extremely rare instances where displaying the full URL&nbsp;is desirable, but this should be the exception, not the norm, and should require a compelling reason.
+Many URLs (website addresses) are long and not&nbsp;reader-friendly. For readability's sake, links should not include the full URL of the destination page. There may be extremely rare instances where displaying the full URL is desirable, but this should be the exception, not the rule, and should be done only if there is a compelling reason.<br>
-'''Correct:''' [http://www.familysearch.org/eng/default.asp FamilySearch]
+==== '''Example 1: a link by itself'''&nbsp;  ====
+'''Correct:''' [http://www.familysearch.org/eng/default.asp FamilySearch]
 '''Incorrect:''' [http://www.familysearch.org/eng/default.asp http://www.familysearch.org/eng/default.asp]
-One reason some wiki users have cited for displaying the full URL is that it will make the article more helpful to users who print the article. However, modern Web browsers print the full URL of linked sites by default even if the full URL is not displayed on users' computer screens while viewing, so this is not really an issue.
+==== Example 2: a link in context  ====
+'''Correct:'''&nbsp;[https://eservices.archives.gov/orderonline/start.swe?SWECmd=GotoView&SWEView=GPEA+Product+Detail+-+Features+View+FFO&SWEHo=eservices.archives.gov&SWETS=1199728061&SWEPostnApplet=GPEA+Product+Form Order United States military records] online.
+'''Incorrect:''' Go to [https://eservices.archives.gov/orderonline/start.swe?SWECmd=GotoView&SWEView=GPEA+Product+Detail+-+Features+View+FFO&SWEHo=eservices.archives.gov&SWETS=1199728061&SWEPostnApplet=GPEA+Product+Form https://eservices.archives.gov/orderonline/start.swe?SWECmd=GotoView&amp;SWEView=GPEA+Product+Detail+-+Features+View+FFO&amp;SWEHo=eservices.archives.gov&amp;SWETS=1199728061&amp;SWEPostnApplet=GPEA+Product+Form]
+[https://eservices.archives.gov/orderonline/start.swe?SWECmd=GotoView&SWEView=GPEA+Product+Detail+-+Features+View+FFO&SWEHo=eservices.archives.gov&SWETS=1199728061&SWEPostnApplet=GPEA+Product+Form +Applet+FFO&amp;SWEPostnRowId=1-N9YP]&nbsp;to order United States military records online.
+Clearly, the first link is much easier to read, takes less space, and helps users understand what they will find by clicking the link.
 ==== Free web sites  ====