Difference between revisions of "Guidelines"

From Scriptwiki
Jump to: navigation, search
Line 38: Line 38:
  
  
Feel free to ask any editor if you are unsure about specific subjects. To get examples, just take a look at already added articles.
+
Feel free to ask any editor if you are unsure about specific subjects. To get an example, just take a look at already added articles.

Revision as of 12:59, 5 May 2006

As this wiki is supposed to be very user-friendly, all articles should follow the guidelines listed in here. Please note that we will not accept any articles not following these rules and reserve the right to block your account in case you break these rules repeatedly.


Topic (the name of the page) examples

  • $variable
  • Command
  • On_join
  • If-Then-Else

First line of the text

  • Short description what it does / what it's good for.
    • Example: Returns the Nth token in text. A token is blah blah blah.

Second line of the text

  • The syntax, starting with a space to get a box around it.
    • Example: (space)$gettok(text,N,C)

Next one/few line(s) of the text

  • Explanation what the non-trivial parameters mean. The parameter(s) is/are to be inside '' '' to make it italic.
    • Example: C is the ascii number of the character that is set to separate the tokens blah blah.

Next one/few line(s) of the text

  • Short example(s) how to use the command/identifier/whatever. The (possible) return value is to be inside '' '' to make it italic.
    • Example: //echo -a $gettok(this.is.text,2,46) returns is.

Sections

  • If the command/identifier/whatever is complex enough to be needed to demonstrate further, use == Examples == to start a section with more examples. Remember to add links to other wiki items such as [[var]] for the first occurence in each article. All example lines are to be started with a space and all return values are to be put inside '' ''.

Add "See also" and Category

  • It's good to add a 'see also' section with == See also == at the end of the article that contains useful links to similar commands/identifiers/whatever. Remember also to add the article to the correct category/categories with adding [[Category:name_of_the_category]] at the end. Like [[Category:Text and Number Identifiers]].

Stubs

  • If you know your article is incomplete you can add {{Stub}} marking it as incomplete and placing it in the Category:Stubs for others/yourself to complete later on. It appears to look the best if you add it at the top of the page. To make sure whoever reads the article knows that it is incomplete.

Shared articles

  • {{Disambling}} is used to split articles into smaller pieces when article holds reference to more than one article and it's not unambiguous where it should belong.


Feel free to ask any editor if you are unsure about specific subjects. To get an example, just take a look at already added articles.