Difference between revisions of "Writing Short Article Names"

From ArchWiki
Jump to: navigation, search
m
m
Line 1: Line 1:
 
[[Category:ArchWiki Help (English)]]
 
[[Category:ArchWiki Help (English)]]
  
:''Short article names both save space on the page, and also improve readability of article listings.''
+
{{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.}}
:''This short HOWTO will show you how to shorten an article name.''
+
{{Article summary heading|Available in languages:}}
 
+
{{I18n entry|English|Short article names HOWTO (English)}}
 +
{{Article summary heading|Series}}
 +
{{Article summary wiki|Short article names HOWTO (English)}}
 +
{{Article summary wiki|Writing article overviews HOWTO (English)}}
 +
{{Article summary wiki|Writing article introductions HOWTO (English)}}
 +
{{Article summary wiki|Effective use of headers HOWTO (English)}}
 +
{{Article summary heading|Related articles}}
 +
{{Article summary wiki|ArchWiki Tutorial}}
 +
{{Article summary wiki|Help:Editing}}
 +
{{Article summary end}}
  
 
==Who should read this article==
 
==Who should read this article==
Line 77: Line 86:
 
*Speed up pacman download using '''other''' downloaders
 
*Speed up pacman download using '''other''' downloaders
 
*Speed up pacman download using '''external''' downloaders
 
*Speed up pacman download using '''external''' downloaders
 
== Related topics ==
 
 
For more information on how to format wiki pages, read the [[ArchWiki Tutorial]], and also the more technical [[Help: Editing|this HOWTO on editing]].
 
 
Also take a look at these articles:
 
 
*[[Writing article introductions HOWTO (English)]]
 
*[[Writing article overviews HOWTO (English)]]
 
*[[Effective use of headers HOWTO (English)]]
 

Revision as of 11:05, 29 November 2006

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

Instead of saying alternative, you may say other.

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

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