Difference between revisions of "Writing Short Article Names"

From ArchWiki
Jump to: navigation, search
m
(General cleanup)
Line 1: Line 1:
 
[[Category:ArchWiki Help (English)]]
 
[[Category:ArchWiki Help (English)]]
 
 
{{Article summary start}}
 
{{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 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.}}
Line 15: Line 14:
 
{{Article summary end}}
 
{{Article summary end}}
  
==Who should read this article==
+
== Who should read this article ==
  
 
This article was written to assist wiki writers and editors in creating effective articles and expand the ArchWiki readers' experience.
 
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]].
+
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 ==
 
== Introduction ==
Line 29: Line 28:
 
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.
 
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.
+
{{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 ==
 
== Avoid using question form ==
Line 50: Line 48:
 
*'''Speed up pacman download''' using alternative download managers
 
*'''Speed up pacman download''' using alternative download managers
  
== Avoid facy words ==
+
== Avoid fancy words ==
  
Facy 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.
+
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''.
 
Instead of saying ''alternative'', you may say ''other''.
  
Comapre the two versions:
+
Compare the two versions:
  
 
*Speed up pacman download using '''alternative''' download managers
 
*Speed up pacman download using '''alternative''' download managers
Line 79: Line 77:
 
*Speed up pacman download using other downloaders
 
*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. So, 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''.
+
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:
 
Compare:

Revision as of 21:30, 17 November 2009

Template:Article summary start Template:Article summary text Template:Article summary heading Template:I18n entry Template:Article summary heading Template:Article summary wiki Template:Article summary wiki Template:Article summary wiki Template:Article summary wiki Template:Article summary heading Template:Article summary wiki Template:Article summary wiki Template:Article summary end

Who should read this article

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 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