Beautiful banners are coming to every article and you can help!
Check out our guidelines and learn how to create your own!

Difference between revisions of "Wikitravel:Manual of style"

From Wikitravel
Jump to: navigation, search
(Formatting style)
(banner)
 
(22 intermediate revisions by 9 users not shown)
Line 1: Line 1:
Our '''Manual of style''' is a collection of rules of thumb and guidelines for giving Wikitravel a consistent look and feel. Most of these rules have exceptions, but to put together a good reference work collaboratively, it's best to follow the rules unless they're quite inappropriate for a particular situation.
+
{{pagebanner|Wikitravel Manual of style Banner.jpg}}
 +
{{Shortcut|[[MoS]]}}
 +
Our '''Manual of Style''' is a collection of rules-of-thumb and guidelines for giving Wikitravel a consistent look and feel. Many of these rules have exceptions, but to put together a good reference work collaboratively, it's best to follow the rules unless they're quite inappropriate for a particular situation.
  
The Manual is broken up into different pages so that this one doesn't get overloaded with extraneous text. It makes it easier to find and update individual rules or concepts if they're on their own pages. Finally, it's easier for smarty-pantses to link to the particular rule being broken from [[Wikitravel:using talk pages|talk pages]] for articles.
+
The manual is broken up into different pages so that this one doesn't get overloaded with extraneous text. It makes it easier to find and update individual rules or concepts if they're on their own pages. Also, having separate articles makes it easier to link to the particular rule being broken from [[Wikitravel:using discussion pages|discussion pages]] for articles and in edit summaries.
  
 
If all this stuff makes your head swim, and you don't want to bother with it, by all means [[Wikitravel:plunge forward|plunge forward]] and just start sharing your knowledge. Other [[Wikitravel:Wikitravellers|Wikitravellers]] will come through and bring your contributions more in line with the style guide.
 
If all this stuff makes your head swim, and you don't want to bother with it, by all means [[Wikitravel:plunge forward|plunge forward]] and just start sharing your knowledge. Other [[Wikitravel:Wikitravellers|Wikitravellers]] will come through and bring your contributions more in line with the style guide.
  
If you have a question about the specifics of the Manual, or want to see it changed/amended/clarified, use the [[Wikitravel:using talk pages|talk page]] for the section in question. A list of issues currently being discussed can be found [[Wikitravel:Requests for comment|here]].
+
If you have a question about the specifics of the manual, or want to see it changed/amended/clarified, use the [[Wikitravel:using discussion pages|discussion page]] for the section in question. A list of issues currently being discussed can be found [[Wikitravel:Requests for comment|here]].
  
 
==Structural style==
 
==Structural style==
 
+
This section of the manual is for rules about the structure of '''Wikitravel as a whole'''.
This section of the Manual is for rules about the structure of '''Wikitravel as a whole'''.
+
 
+
 
* [[Wikitravel:Main Page guidelines|Main Page guidelines]] – how to add links to the [[Main Page]]
 
* [[Wikitravel:Main Page guidelines|Main Page guidelines]] – how to add links to the [[Main Page]]
 
* [[Wikitravel:What is an article?|What is an article?]] – how and when to start new articles
 
* [[Wikitravel:What is an article?|What is an article?]] – how and when to start new articles
Line 23: Line 23:
  
 
==Formatting style==
 
==Formatting style==
 
 
These rules are about '''laying out individual articles'''. That is, they describe how we take raw information and put it in a format that's easily usable by travellers.
 
These rules are about '''laying out individual articles'''. That is, they describe how we take raw information and put it in a format that's easily usable by travellers.
  
Line 54: Line 53:
  
 
==Writing style==
 
==Writing style==
 
 
This set of rules describes how to write '''words, sentences, and paragraphs'''.  
 
This set of rules describes how to write '''words, sentences, and paragraphs'''.  
 
 
* [[Wikitravel:Tone|Tone]] – the right tone for your prose
 
* [[Wikitravel:Tone|Tone]] – the right tone for your prose
 
* [[Wikitravel:Don't tout|Don't tout]] – describe, don't push
 
* [[Wikitravel:Don't tout|Don't tout]] – describe, don't push
Line 80: Line 77:
  
 
==See also==
 
==See also==
 
 
* [[Wikitravel:Help|Help]] – for technical help with Wiki syntax
 
* [[Wikitravel:Help|Help]] – for technical help with Wiki syntax
 
* [[Wikitravel:Community policies|Community policies]] – for Wikitravel's collaboration policies
 
* [[Wikitravel:Community policies|Community policies]] – for Wikitravel's collaboration policies
 
* [[Wikitravel:Namespace index]] – all the "meta" articles in the Wikitravel: namespace
 
* [[Wikitravel:Namespace index]] – all the "meta" articles in the Wikitravel: namespace
* [[Wikitravel:Using talk pages|Using talk pages]]
+
* [[Wikitravel:Using discussion pages|Using discussion pages]]
 
* [[Wikitravel:Manual of style for the US]]
 
* [[Wikitravel:Manual of style for the US]]
  

Latest revision as of 09:40, 13 June 2015

Our Manual of Style is a collection of rules-of-thumb and guidelines for giving Wikitravel a consistent look and feel. Many of these rules have exceptions, but to put together a good reference work collaboratively, it's best to follow the rules unless they're quite inappropriate for a particular situation.

The manual is broken up into different pages so that this one doesn't get overloaded with extraneous text. It makes it easier to find and update individual rules or concepts if they're on their own pages. Also, having separate articles makes it easier to link to the particular rule being broken from discussion pages for articles and in edit summaries.

If all this stuff makes your head swim, and you don't want to bother with it, by all means plunge forward and just start sharing your knowledge. Other Wikitravellers will come through and bring your contributions more in line with the style guide.

If you have a question about the specifics of the manual, or want to see it changed/amended/clarified, use the discussion page for the section in question. A list of issues currently being discussed can be found here.

Structural style[edit]

This section of the manual is for rules about the structure of Wikitravel as a whole.

Formatting style[edit]

These rules are about laying out individual articles. That is, they describe how we take raw information and put it in a format that's easily usable by travellers.

Article layout[edit]

Formatting content[edit]

  • Section headers – formatting guidelines for the section headers
  • Avoid HTML – avoiding HTML formatting
  • Information boxes – when, how and when not to use information boxes
  • Geocoding – adding latitude and longitude to destination articles
  • Wiki markup – How to use the special Mediawiki markup to present information

Links[edit]

Listings[edit]

Writing style[edit]

This set of rules describes how to write words, sentences, and paragraphs.

See also[edit]

Variants

Actions

Destination Docents

In other languages