Contributing

This page is a start point in helping people to contribute to the wiki.

Here is what you need to do:

1. login as a user (using the link in the top right and the details you got in your welcome email)
2. read through the site to either find a page you think your contribution would be appropirate to or one where there ought to be a link from to a new page on your chosen field of expertise.
3. play with the sandbox to make sure you understand page editing
4. if the page you want doesn't exist you need to add a link to it on another page to get it created and then click on the link and create the page (see below for how)
5. if the page already exists you can edit it and add your material (see below for how)

If you are a registered user you will be able to edit some pages when you are logged in. If you are not sure whether or not you are logged in looked at the top right hand of the web page. If it says 'logout' then you are logged in and can carry on.

If on the other hand it says 'login' then you need to click on 'Login' and give your username and password. Once you are logged in you can continue.

To edit a page you first need to have it on your screen. Once you have done that you can click either:

• click on the 'edit this page' link if you want to edit the whole page; or
• click on an [edit] bit at the bottom of a section that you would like to change. Doing this just lets you edit the section you have chosen.

Once you have done this you get the page editor, see below for some outline of how to use it. If you don't have any 'edit' links then it means that you do not have permission to edit that page. If you think that you should, or you want to correct an error, then please send an email to ruberta or the page owner (you should see their name in the tags at the bottom of the page).

1. Create a link on an existing page
2. click on the link
3. on the new page click on 'create this page' (if visible - otherwise mail ruberta with the link details)
4. edit the page in the same was as for existing pages

Note that when you create pages the first heading used in the page is usually used as the page title in any links (although there are ways to over-ride this in individual links).

When you create a new page

• You are the page owner unless you have agreed otherwise with someone else who will be the page owner
• you must tag it
• tag the page owner using the username.

Most pages should do this automatically, but you should review the tags and ensure that they are appropriate. See Common Tags for details on how to use tags.

Play in the sandbox to try all this out.

You will get an edit box with a toolbar on the top that lets you apply some simple formatting. If you hold your mouse over the icons on the toolbar then it will tell you what the functions are.

The most common bits you may want to type (rather than use the toolbar) are adding links, especially to other pages.

• Links are denoted by double square brackets ]] enclosing the link location
• external URLs e.g. http://www.gov.uk/ can just be typed in
• internal links use the page name, see Page Names for details on how to construct them if you have to. Pages in sub-folders have the format :folder:sub-folder:pagename note the leading colon.
• links to U: drive take the form \\ukps.ho\dfs\shared\CFP\_WCFP\TA Organisational Transformation\W Work Areas\01 Business Design Authority\02 Architecture\04 Reference Papers\20130501 IPS IT Roadmap Capability Tree v01 JMK.vsd
  You can do this easily by pasting from an email link and then stripping 'file : / /' from the front.

Paragraphs work by just putting a couple of line breaks in. Note you don't need to manually wrap text, let the editor do that itself. Also if you indent text it gets put in a coloured box.

See the Formatting Syntax page to get a full explanation.