Difference between revisions of "Writing Short Article Names"

From ArchWiki
Jump to: navigation, search
m (+ related)
(restore lost link fragment)
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Category:ArchWiki Help (English)]]
+
#REDIRECT [[Help:Article naming guidelines#Shorten article names]]
{{i18n|Writing Short Article Names}}
+
{{Merge|Article Naming Guidelines}}
+
{{Article summary start}}
+
{{Article summary text|Short article names both save space on the page, and also improve readability of article listings. This short HOWTO will show you how to shorten an article name.}}
+
{{Article summary heading|Series}}
+
{{Article summary wiki|Writing Short Article Names}}
+
{{Article summary wiki|Writing Article Overviews}}
+
{{Article summary wiki|Writing Article Introductions}}
+
{{Article summary wiki|Effective Use of Headers}}
+
{{Article summary heading|Related}}
+
{{Article summary wiki|Help:Editing}}
+
{{Article summary wiki|Help:Style}}
+
{{Article summary wiki|Article Naming Guidelines}}
+
{{Article summary end}}
+
 
+
This article was written to assist wiki writers and editors in creating effective articles and expand the ArchWiki readers' experience.
+
 
+
You are not required to know how to edit a wiki page in order to follow this article. This page is a more general style guide, rather than a [[Help:Editing|technical editing HOWTO]].
+
 
+
== Introduction ==
+
 
+
For this article, we will use this name as an example:
+
 
+
*How to improve pacman download speed using alternative download managers
+
 
+
We will cover a few techniques that will help us shorten the name. There are probably many more techniques that do not apply to this particular example, but you will still get insight into the ''concept'' of title editing.
+
 
+
{{Warning|Literal translation of this article may prove to be a challenge for most languages. Please try to find alternative titles that may serve better for your language. Also, other languages may require different techniques than English.}}
+
 
+
== Avoid using question form ==
+
 
+
Instead of saying ''How to improve'', simply say ''Improve''.
+
 
+
Now compare the two:
+
 
+
*'''How to improve''' pacman download speed using alternative download managers
+
*'''Improve''' pacman download speed using alternative download managers
+
 
+
== Rewording long parts ==
+
 
+
The text ''Improve pacman download speed'' is rather long. Instead, we will say ''Speed up pacman download''
+
 
+
Now compare:
+
 
+
*'''Improve pacman download speed''' using alternative download managers
+
*'''Speed up pacman download''' using alternative download managers
+
 
+
== Avoid fancy words ==
+
 
+
Fancy words (like ''alternative'' in our example) are not only fancy; they are used less often than ordinary words, and thus tend to be longer. It is well known that words that are used regularly are in most cases shorter, so try to find an ordinary alternative for your words.
+
 
+
Instead of saying ''alternative'', you may say ''other''.
+
 
+
Compare the two versions:
+
 
+
*Speed up pacman download using '''alternative''' download managers
+
*Speed up pacman download using '''other''' download managers
+
 
+
== Deviating from formal technical expressions ==
+
 
+
This may be frowned upon by some of the more technically oriented users, but most people would not mind at all. Avoid technical terms if that makes your article names shorter.
+
 
+
Instead of saying ''download managers'', you may say ''downloaders''.
+
 
+
Compare:
+
 
+
*Speed up pacman download using other '''download managers'''
+
*Speed up pacman download using other '''downloaders'''
+
 
+
== Review the result ==
+
 
+
Do not get too excited yet. We still need to review the two titles and see if they still communicate the same meaning.
+
 
+
*How to improve pacman download speed using alternative download managers
+
*Speed up pacman download using other downloaders
+
 
+
Okay, we see the end result is a much shorter article name, but what about its meaning? Well, it certainly seems like we did a good job. But now we have a different problem. pacman is ''not'' a downloader; both ''alternative download managers'' and ''other downloaders'' imply that pacman ''is'' a downloader, which is not what we want. We need to change the meaning by saying ''external downloaders''.
+
 
+
Compare:
+
 
+
*How to improve pacman download speed using '''alternative''' download managers
+
*Speed up pacman download using '''other''' downloaders
+
*Speed up pacman download using '''external''' downloaders
+

Latest revision as of 13:47, 18 February 2014