This page will cover the recommend practices and guidelines for adding content, pages and editing this wiki. This will help with keeping the wiki content standardized.

Editing Content

To edit a page simply click on the edit button to the right of this text. Its that easy! Now when your in the editing mode there is some new text above your edit window. This text contains information that is helpful for editing. Please read the syntax to learn the syntax for this wiki. Wiki syntax is slightly different than word but is easly learned. Feel free to try new things in the playground.This is a powerful way to keep versioning down for production pages as well as providing a painless way to learn or test features of this wiki.

Do not type passwords in to this wiki. They are plain text and that could cause issues.

Adding Content

Adding content to the wiki is very easy. Before running off and creating a new page, search to see if the subject has already been covered. Type in the search bar above and see if any thing shows up. If something did show up then review the page and see if the information is already there.

Create a new Page

Using the search option

After following the guide line above the fastest way to create a page is to search for it.

search: page that im trying to find 
result: page_that_im_trying_to_find

If the page doesn't exist yet this will give you the option to create a new page at the right side of the wiki. Now the new page isn't sorted. Think a huge stack of papers thrown on the floor. Wiki's can search this and find stuff no problem but if we wanted to provide some structure and add folders we will want to use the following instead.

:namespace:pagename

Dokuwiki sorts pages using namespaces(folders). In this example I know that vmware is managed by the Network team so I entered

:networking

This tells the wiki to place the new page under the networking tree. The next part of the command is the page its self. So in this example our search would be:

 :networking:vmware

The Link option is slightly different in syntax. we place brackets around our directory tree to get the page placed in the correct location.

[[:namespace:page]]

This link will appear as red text to alert us that the page has not yet been created. Once someone edits the linked page the link color will change to green. So referring back to our example the following line would create the vmware wiki page using a link.

[[:networking:vmware]]

The bottom line is to just add content to the wiki. Then ask someone to fix the formatting.

If you have any questions please post on https://msp.zone and choose the #documentation channel.