The first rule: Have fun. The second rule: You know that guy. Don't be that guy. The third rule: If there are any questions, ask.
Each of you has assigned a main motivational process (identity, goal-setting, competence etc.) that you are responsible for as an editor. This means:
This does not mean
In the pattern and lens template, you will find a heading “Authors”. The simple (well) rule here is: Everyone who has made a significant contribution to a page (beyond fixing spelling or adding a link) should be credited as one author under that heading. Authors should be listed in the order of their contribution: Who contributed the most is listed first, and so on. In practice, this will likely mean that most of the time, the person starting a pattern and making the first draft will be the first author. If you start a new page or make a significant change to it, simply add your name (in the right order) under the header “Authors”.
If you simply wish to add to or edit an existing page, unless the editor of that section has specified a different process, just go forth and add/edit. When you edit a page, underneath the edit window is a little field titled “Edit summary”. It is polite to fill that out and describe what edit you made before you hit “Save”.
If you have disagreements, comments, or additions that you feel you would like to discuss with others or the editor first (what on Wikipedia would happen on the “Talk” page of an article), there's a section conveniently titled “Discussion” under each page that effectively functions like a comment thread – use that. The “Discussion” section will not be visible to regular visitors of the wiki that are not logged-in as users.
DokuWiki operates with namespaces, which are similar to folders or directories, and pages, which are basic files.
Namespaces can be nested, and a page can only ever belong to one (nested) namespace.
To add a page to a namespace (and pages can only belong to one namespace), when naming a page, simply write the namespace(s) it belongs to before its pagename, separated by a colon:
main_namespace:sub_namespace:subsub_namespace:pagename
For instance:
motivation:curiosity components:feedback:juicy_feedback
The convention of this wiki is that there are four main namespaces:
about
contains all “meta” content – editing guidelines, contributor pages, and so on;motivations
contains the main motivation pages: competence, autonomy, curiosity, etc.;components
contains the main pages for different components of a game, separated into “mechanics”, “fiction”, and “interface”.lenses
holds the patterns and lenses.
This means that when you create a new pattern or lens, you should create a page that you name so that it belongs to the namespace lenses
, like so
lenses:lens_or_patternname
In order to keep our wiki useful, we need some controlled vocabulary. This is specifically important for cross-linking and cross-referencing. As you see in the sidebar, I have created a core set of pages for standing terms that constitute the “Categories” – essentially the “tags” – that each pattern or lens links to.
The rules are:
Embed images! But if you do, please (a) use your own in-game screenshots and credit them as “Image: Your name”, or (b) if you use other people's images, ideally choose open content-licensed images (such as Creative Commons) and credit the original source in the form
Image: Source, licence Image: Jon Doe, cc:by-nc
where the name of the source is linked to the original image site, and the name of the licence is linked to the licence.
If you embed videos (and again, please do!), and you use a regular sharing site such as YouTube or Vimeo, just use the embed manager (see image above), and you're golden.
Linking is good. We like linking. If you mention a game, ideally, link the first time you mention the game's name to that game's page on Mobygames.com.
At the end of each pattern or lens, there is a section “References”. This is where all the scientific and industry literature you have found on your pattern goes. We use the APA style of referencing. You can use Google Scholar or Zotero or another citation manager to help you generate properly formatted references.