Skip to main content

Wiki Guidelines

Style

Authors should adopt a neutral, objective, and fact-based tone. The style should be clear, concise, and accessible, avoiding personal opinions or biases.

The writer's primary aim is to inform, not to persuade, ensuring that all content is supported by reliable documentation and verifiable facts.

The attitude should be one of humility, recognizing that the goal is to contribute to a shared resource, and thus collaboration, respect for the work of others.

You can write more personal contents in the comments, or put your name on top of a section to identify yourself as the author.

Revision

There is an option in the wiki to see the changes done by users by clicking on revision. The idea of the wiki is to create a neutral, objective, fact-base knowledge (ideally without people's name), but we can always see who added the information by clinking on revision:

510d3422-8639-4c2a-805b-31337ecf90c8.png


clicking the changes by your chosen user, you get:


2969a4d3-984b-41dc-b2f0-bb937dcdb7c0.png



Which is what you can see automatically when anyone edits any page of the book you watch.

Public pages or User only

What is our policy for the view of the content. User only with only some pages public?

Usage of Data

Prefer Google Drive over Wiki for large amount of data (images, PDFs, video, audio, etc.) 

Need to have a good way of linking the data to the wiki 

Usage of username 

In my experience, it is much better to use a personal account, instead of a position account in the wiki. I.e. Cittadhammo Bhikkhu (cittadhammo@amaravati.org) instead of Anonymous Recycling Officer (waste@amaravati.org). This for the following reasons:

  1. You don't know who is speaking in the comment, or who created/modified a page if a position account is used. Over time, different people will occupy 
  2. Position are good for handling emails account under an office job (position), but not for personal interaction with a community software. 
  3. People will change their office over time, but you want them to keep using the wiki with a continuous account and be able to log in even when they retire from an office.
  4. When someone else takes the office, the old person cannot use the wiki and has to create a new account with all his profile and set up changed.
  5. When you take a new office, you don't want the previous officer settings, comments, watches in your wiki account. 
  6. People should have a personal wiki account and their name can temporary being mentioned on an office page like Recycling Officer with the office email. When the officer change, just change the name on the office page.
  7. If you have multiple office, it doesn't make sense to have to change account when you use the wiki. It is not like an inbox where you can switch between perso and work. A wiki is a work environment where real people (not officer position) interact. 
  8. More to come... ;-)