When editing pages just keep the following rules in mind:

General#

  • Be gentle - don't be rude or offensive.
  • Write in a way that is easy to understand and avoid local slang or phrases. Many of those who will read your text may not have English as their first language.
  • Don't delete other people's contributions (unless you know what you are doing)
  • Don't use too many acronyms (or at least, have a page explaining them)
  • Avoid the "click here" phrase!! Don't write: "Click here for more info about etiquette" but use "More info about WikiEtiquette". Avoid for external links as well.
  • Contribute only original stuff. Links are fine, but don't cut-and-paste from copyrighted things.
  • Correcting typos is quite okay - in fact, it's a very good habit, since it makes the web page more readable.
  • Use absolute date references. You never know when someone will be reading your content in the future. Example: "As of December 2005, we are the only competitor in this market." Not, "As of now, we are the only..."
  • Avoid self-referencing pronouns. Instead of "I think the best method for..." try "Some think the best method for..." You are not the only author of a page over time.
  • You are free to contribute anonymously, but it is preferred that you sign your comments with your name (or handle). It is common to prepend the signature with '--' like this: -- Janne Jalkanen (While you're at it, you are free to create your own wikipage and tell us about yourself.)
  • Another good way to identify yourself is to put your name first, like this: Janne Jalkanen : I'd like to say that... or use the third person if you don't think it sounds a bit grand AndrewCates agrees.
  • Think before you comment. WikiWiki is not a high-speed conversation board. It's not a news server either. What you say will stay here forever (yeah, we do make backups) for everyone to see and comment.

Creating WikiNames#

  • A good WikiName is short and descriptive. If the name is logical and easy many more people will link to it.
  • Although you can take a whole sentence and crunch it up to make a WikiName, it is better style to restrain it to at most 5 words.
  • Instead, try to use WikiNames as you would use chapter titles in a book.
  • This Wiki allows you to create pages with a single word as a name, but try to use at least two words - we don't want to exhaust the name space :-).
  • Double-check WikiNames for typos - otherwise someone will create a misnamed page! Misnamed pages are bad, since linking to them requires more effort than to a logical, correct WikiName.
  • AndrewCates asks that you please try to check whether a possible duplicate exists for your WikiWord before creating a new page. Duplicates increase the word number and navigation problems enormously

Refactoring pages#

Refactoring is the process where you sum up a page, shortening it, making it more accessible. Anyone who feels up to it may go ahead, but we suggest that you leave it up to frequent (experienced) visitors.

  • Be objective - both pros and cons should be represented correctly.
  • Be careful with signed contributions - don't change their meaning.
  • Give credit where credit is due.
  • Use 3rd person or plural instead of 1st person singular in your summary.

( Thanks to Sensei's library for this initial text!! )


Add new attachment

Only authorized users are allowed to upload new attachments.

List of attachments

Kind Attachment Name Size Version Date Modified Author Change note
doc
工单系统运维需求.doc 347.1 kB 1 27-Jun-2012 04:55 Dongwen,wang sdfsdgfs
« This page (revision-316) was last changed on 10-Jun-2012 10:53 by Janne Jalkanen