From The Mana World
m (Cassy moved page TheManaWorld:Wiki Guidelines to Help:Wiki Guidelines: this should be in "Help:")
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Status_red}}
{{Status_red}}
{{Status_construction|message = Visit the following forum thread [http://forums.themanaworld.org/viewtopic.php?f=11&t=16110 Website development/Wiki: Development part]}}
{{Status Under Construction|Visit the following forum thread [http://forums.themanaworld.org/viewtopic.php?f=11&t=16110 Website development/Wiki: Development part]}}


This article is to bring a little bit more order into the wiki.
This article is to bring a little bit more order into the wiki.
Line 13: Line 13:


==Commenting articles==
==Commenting articles==
'''Discussion pages are meant for discussing articles'''. Putting comments right on the article page where they are much more prominent is much more productive for the development of a topic. But the habit of some people to write comments '''directly''' into the text is a bad method because it harms the readability of the article a lot.
*Discussion pages are meant for discussing articles.
**Putting comments into pages led players and new developers to believe certain "comments" were true even when a page was marked under construction.


So comments about articles should not be written into the article itself but collected in discussion page or as another subsection labeled <nowiki>==Comments==</nowiki> at the end of the article.
==Creating Editing Articles==
 
*Check Discussion
Every comment '''has to be signed and dated'''. You can automatically add your username and the present time and date by typing :
*Make sure you're not duplicating a obscure page
 
*Does it need a page or could it be a sub-topic on an existing page?
{| class="wikitable" border="1"
*Please use forum post instead with a poll option to get a social barometer of your work.
| <nowiki>--~~~~</nowiki> ||--[[User:Nard|Nard]] 08:48, 22 November 2012 (CET)
*Encourage others to give input and feedback
|-
*If the article is not currently under construction be sure to set it to such before starting work. Even if you are creating it under your namespace.
| <nowiki>~~~~</nowiki> || [[User:Nard|Nard]] 08:48, 22 November 2012 (CET)
*If the page is not new, blank, minimal populated, please create the page under your namespace User:<YourUserName>/<NewPage> for example: [[User:Cassy]] has done a great job.
|}
 
 
Comment on comments should be indented so that the discussion structure is visible. You can indent a paragraph by adding ':' in front of it.
 
Example for a discussion:
<pre><nowiki>
I like the color blue --~~~~
:I don't like blue. I would prefer red.
::Red? No, that is too aggressive.
:How about green?
::Green would be an alternative.
:::No, green sucks. Blue is the only alternative.
</nowiki></pre>
 
results in:
 
I like the color blue --[[User:Nard|Nard]] 08:48, 22 November 2012 (CET)
:I don't like blue. I would prefer red.
::Red? No, that is too aggressive.
:How about green?
::Green would be an alternative.
:::No, green sucks. Blue is the only alternative.
 
==Using the approval and disapproval template==
 
''This protocol is actually underused and not pracical, it also make the number of categories and template inflate with no useful consequence. To discuss a page or group of pages please use forum instead, eventually with a poll option.''
 
The approval and disapproval template is a general barometer of the acceptance of a certain idea in the tmw community. Everyone is allowed to put himself either in the list of approving people or opposing people.
 
When you add yourself to the list of approvers or opposers you should also explain your reasons for approving or disapproving the article in the comments.
 
Note that this isn't a democratic voting. The list of supporters and opposers of a proposal is only a suggestion to the people who are in charge of implementing the proposal. It is up to the development team how they value the opinion of each person.
 
Example for an opinion template:
<pre><nowiki>
{{Opinions
|
{{Pro|Supporter1}}
{{Pro|Supporter2}}
|
{{Contra|Opposer1}}
{{Contra|Opposer2}}
}}
</nowiki></pre>
When someone is added to the list of approvers or opposers of an article by using the <nowiki>{{Pro|X}}</nowiki> or <nowiki>{{Contra|X}}</nowiki> template, the article is automatically added to the category "Approved by X" or "Opposed by X".
 
Note that all supporters are listed between the first and second pipe, while all opposers are listed after the second pipe. This is important because otherwise you will be listed on the wrong side of the table no matter if you use the <nowiki>{{Contra|}}</nowiki> or <nowiki>{{Pro|}}</nowiki> template.


==Internal links==
==Internal links==
Line 91: Line 44:
*You document something that has already been implemented without writing a wiki article about it.
*You document something that has already been implemented without writing a wiki article about it.


The article is referenced in [[:Category:Proposal]], [[:Category:Unevaluated Proposals]].
===[[Template:Status_yellow|Yellow]]===
===[[Template:Status_yellow|Yellow]]===
The <nowiki>{{Status_yellow}}</nowiki> indicates that the developer that is in charge of the mentioned aspect of the game as decided that the proposal mentioned will be done in the game as described. The template should only be placed by the developer in charge or after getting his/her permission to place it in the article.
The <nowiki>{{Status_yellow}}</nowiki> indicates that the developer that is in charge of the mentioned aspect of the game as decided that the proposal mentioned will be done in the game as described. The template should only be placed by the developer in charge or after getting his/her permission to place it in the article. The article is referenced in [[:Category:Proposal]], [[:Category:Evaluated Proposals]], [[:Category:Compatible Proposals]], [[:Category:Accepted Proposals]].


===[[Template:Status_green|Green]]===
===[[Template:Status_green|Green]]===
The <nowiki>{{Status_green}}</nowiki> indicates that the aspects mentioned in the article are already in the game. Articles that explain how different aspects of the game work, style guidelines (when they are ratified) or tutorials fall into this category, too.
The <nowiki>{{Status_green}}</nowiki> indicates that the aspects mentioned in the article are already in the game. Articles that explain how different aspects of the game work, style guidelines (when they are ratified) or tutorials fall into this category, too. The article is referenced in [[:Category:Reference]].


===[[Template:Status_outdated|Outdated]]===
===[[Template:Status_outdated|Outdated]]===
The <nowiki>{{Status_outdated}}</nowiki> article indicates that the article is either a status green article that is no longer correct or a status red or yellow article that has been rendered depreciated by a contradicting developers decision.
The <nowiki>{{Status_outdated}}</nowiki> article indicates that the article is either a status green article that is no longer correct or a status red or yellow article that has been rendered depreciated by a contradicting developers decision. The article is referenced in [[:Category:Outdated]].


===[[Template:Status_construction|Under Construction]]===
===[[Template:Status Under Construction|Status Under Construction]]===
The <nowiki>{{Status_construction|*}}</nowiki> template explains that the current article is in development. It has to contain a notice how to take part in the development of the article. Replace the asterix in the example above with a description how to contact the developers.
{{:Template:Status Under Construction/doc}}


Examples:
<pre><nowiki>
{{Status_construction|message = come to the IRC channel #tmwart on irc.freenode.net}}
{{Status_construction|message =visit the following forum thread [link]}}
{{Status_construction|message =Add your opinion to the comment section}}
</nowiki></pre>
== Categorize Articles==
== Categorize Articles==


Latest revision as of 08:05, 9 March 2015

This article is currently only a proposal

The features or design guidelines described in this article are only a proposal made by one or some persons. It has not been evaluated or accepted by the core development team yet. Feel free to add your personal opinion about them or make counter proposals.

Construction-worker.png
❝ This article is currently under construction.❞



This article is to bring a little bit more order into the wiki.

The purpose of the wiki

The wiki is meant to publish:

  • Ideas about various aspects of the game
  • Design documents and roadmaps
  • Design guidelines
  • References for current and potential developers
  • Help documents for players

Commenting articles

  • Discussion pages are meant for discussing articles.
    • Putting comments into pages led players and new developers to believe certain "comments" were true even when a page was marked under construction.

Creating Editing Articles

  • Check Discussion
  • Make sure you're not duplicating a obscure page
  • Does it need a page or could it be a sub-topic on an existing page?
  • Please use forum post instead with a poll option to get a social barometer of your work.
  • Encourage others to give input and feedback
  • If the article is not currently under construction be sure to set it to such before starting work. Even if you are creating it under your namespace.
  • If the page is not new, blank, minimal populated, please create the page under your namespace User:<YourUserName>/<NewPage> for example: User:Cassy has done a great job.

Internal links

Internal links are important for the easy navigation of the wiki. Whenever you reference another article you should link to it.

When you create an article that is a counter proposal to another article, you should create a link to the article you are opposing and also put a link on the linked article back to your article at an appropriate place.

When you create a proposal that is based on another proposal (like an article about a race that fits into the backstory) you should also link back to the article you are based on and also create a link in the base article itself.

Also feel free to create links to articles, that do not exist yet, but should exist in your opinion, to encourage someone to create them.

Using status templates

Status templates show how serious the article is treated by the development team. Every article should start with one of the following templates:

Red

The {{Status_red}} indicates that the contents of the article are a proposal made by someone and that the development hasn't discussed about using the proposal yet.

It should be added to every new article you write. The only cases in which you may start an article with another template are:

  • You document something that is a consensus in the whole development time for a long time.
  • You document something that has already been implemented without writing a wiki article about it.

The article is referenced in Category:Proposal, Category:Unevaluated Proposals.

Yellow

The {{Status_yellow}} indicates that the developer that is in charge of the mentioned aspect of the game as decided that the proposal mentioned will be done in the game as described. The template should only be placed by the developer in charge or after getting his/her permission to place it in the article. The article is referenced in Category:Proposal, Category:Evaluated Proposals, Category:Compatible Proposals, Category:Accepted Proposals.

Green

The {{Status_green}} indicates that the aspects mentioned in the article are already in the game. Articles that explain how different aspects of the game work, style guidelines (when they are ratified) or tutorials fall into this category, too. The article is referenced in Category:Reference.

Outdated

The {{Status_outdated}} article indicates that the article is either a status green article that is no longer correct or a status red or yellow article that has been rendered depreciated by a contradicting developers decision. The article is referenced in Category:Outdated.

Status Under Construction

50px-Template-info.png Template documentation:

This is to be used for Labelling and categorizing under construction documentation. It will show the following banner:


Construction-worker.png
❝ This article is currently under construction.❞



or


Construction-worker.png
❝ This article is currently under construction.
Your message❞



Usage:

Copy the following code into your page. By adding "|your text goes here" behind "{{Status Under Construction}}" you can write a message giving more details about why you marked a page as under construction. This is optional.

{{Status Under Construction}}

or:

{{Status Under Construction|Your message}}

The pages where this template is used will be categorized in the "Under Construction" category


Categorize Articles

Improving Wiki

Making templates

  • Verify some one didn't already do the job : Special:Allpages choose Template Namespace or [1]
  • Document your templates so the may be used easily by other users

Categories

Categories are intended to retrieve information easier; almost every page, template and even category should be categorized. Choosing the names as generic as possible is not easy.

  • Document the categories
  • List Categories here: Special:AllPages choose Category Namespace or : [2]

Comments

A proposed addition to this page is being developed in User:Octalot/Wiki_Guidelines_ReEditing Every X_Guidelines page should have links to all pending proposals to change X_Guidelines (already mentioned here in "Internal links"). Would it be worth putting a standard template at the top of the page for links to all pending proposals?. --Octalot 19:18, 25 October 2008 (CEST)

As Nobody opposes to these guidelines I suggest that they are approved. They can also be updated when needed. ( see discussion) --Nard 18:26, 2 September 2012 (CEST)

Retrieved from "https://oldwiki.themanaworld.org/index.php?title=Help:Wiki_Guidelines&oldid=33365"