Shale/WikiGuidelines

The aim of this page is to provide some help / guidelines for people editing or adding new pages to the Shale Wiki.

1. Creating New Shale Pages

New Shale pages should be created using the Shale/Template and be sub-pages of the main Shale Wiki Page - enter the name of the page you want to create below and click on the Create new shale page button to do this automatically. For example if you enter Tutorials a page will be created named Shale/Tutorials.

For more information on creating sub-pages see HelpOnEditing/SubPages and HelpOnPageCreation.

2. Organization of Pages

Please consider carefully The name of a page and where the page will go in the structure. If its likely that alot more pages will be created on this subject area, then consider a new sub-page structure. For example, Clay is probably a good candidate for an addtional sub-page structure, so rather than creating a Shale/ClayFAQ page, a more suitable structure might be...

• Shale/Clay - Clay home page

  • Shale/Clay/FAQ - Clay frequently asked questions

This will allow future Clay pages to be easily added and the standard menu bar Go Up link will allow users to easily navigate back up the structure.

3. Wiki Help and Tips

3.1. Please Use Preview

Every time a page is saved an email message is sent to the Struts Dev mailing list and can create alot of noise there If you use the preview button it renews your lock on the page and allows you to check your changes before saving - hopefully reducing the number of saves you do

3.2. WikiNames

One common problem on pages are WikiNames - that is where the wiki automagically creates a link for captialized words such as FooBar, which it assumes are wiki pages. You can prevent this by putting an exclamation mark (i.e. ! ) before the word - for example !FooBar was used in this sentance to render without a link.

3.3. Help with Links

Because Shale is a single word rather than WikiName, then simply putting the name of the page doesn't generate a correct link. Below are examples of how to render links to Shale pages in this sub page structure:

3.4. Editing Help Pages

The Shale/Template contains examples of some common page formatting techniques - so when you create a new page, you have something to get started with. For more details about editing see the HelpOnEditing page. The MoinMoin HelpOnEditing page is also sometimes useful and more up to date.

3.5. Table of Symbols

The following table lists the symbols/images available and the wiki markup required to use them:

Markup	Display		Markup	Display		Markup	Display		Markup	Display
X-(			:D			<:(			:o
:(			:)			B)			:))
;)			/!\			<!>			(!)
:-?			:\			>:>			|)
:-(			:-)			B-)			:-))
;-)			|-)			(./)			{OK}
{X}			{i}			{1}			{2}
{3}			{*}			{o}

4. Proposed Shale Wiki Changes

This is a temporary section (which will eventually) be removed) to discuss further changes in the Shale Wiki structure.

4.1. Move/Delete Existing pages

There are a number of Shale wiki pages that were created before the current structure was put in place. I propose moving the content of these pages to pages that conform to new page naming convention. According to this page we can put redirects from the old pages to the new - so we need to decide the following:

• Don't agree with this - leave the old pages as they are

• Move the content to the new pages and get wiki admin. to delete old pages.

• Move the content to the new pages and put redirects on the old pages.

One valid question might be why do this? Two reasons:

• Easier for User Navigation and linking, using the sub-page structure.

• Pages Named Shale/!SomePage are automatically included in the Index page.