WikiContent

The current instructions on how to use the wiki are found when you try to edit a page.

 

They are also available on the EditPageHelp wiki page:

 

http://wiki.jboss.org/wiki/Wiki.jsp?page=EditPageHelp

 

Also the SystemInfo page describes the version of JSP Wiki that is being used: 2.1.53-cvs

 

We should point out the difference between the 2 wikis that are used; JBoss Wiki and JSP Wiki. This page points out that the JSPWiki implementation went live on 27th February 2004.

 

There is a documentation license that applies to all information submitted to the wiki:

 

http://wiki.jboss.org/wiki/Wiki.jsp?page=DocumentationLicense

 

This should be pointed out in the Wiki section of the Governance model.

 

 

There are currently some pages on the JSPWiki that explain what the wiki is and how it should be used:

 

Watching the JBoss Wiki with an RSS reader

 

 

All About Wikis page

 

 

Wiki Etiquette

 

The current versions of our wikis are:

 

  • JSPWiki (Version 2.1.53-cvs)

  • JBoss Wiki (Version 1.0beta2)

 

New Design

 

Wikis are an essential tool for online collaboration, allowing rapid growth and centralization of information created by the community. Due to their popularity and usefulness many different wiki products are now available with an ever increasing set of features.

 

The wiki product that jboss.org uses is called JSPWiki and you can find the main page at http://wiki.jboss.org.

 

JSPWiki was chosen at the start of 2004 for a number of reasons including:

 

  • It was open source

  • It was written in Java using standard J2EE components

  • It was actively developed

  • It was easy to install and use 

 

Since going live on 27th February 2004 over 2500 pages have been created, providing information on a wide range of JBoss projects.

 

Note: Care must be taken not to confuse this wiki, commonly referred to as the JBoss Wiki, with a JBoss project of the same name. The JBoss Wiki project is focussed on the development of a wiki portlet (based on JSPWiki) for use in JBoss Portal or any other standards-based portal. The ambiguity in the name is unfortunate, especially since the JBoss.ORG team use the JBoss Wiki portlet for their own wiki located at http://labs.jboss.com/wiki. This wiki contains information regarding the ongoing development of the jboss.org site.

 

To avoid confusion, any references to JBoss Wiki from this point onwards will refer to the wiki located at http://wiki.jboss.org.

 

Using the wiki

 

Using the wiki is as simple as pointing your browser to the main page and clicking on the links you are interested in. To keep the layout as logical as possible, users are encouraged to search for appropriate pages to place links to any new content. For example if a user creates a new page with a tip on configuring JBoss Security they should place a link on the JBoss Security page or subpages, instead of on the Main page.

 

Anyone can read the wiki anonymously at any time but if you wish to create or edit a page then you first need to login to your jboss.org account. If you don't have a jboss.org account then you can register for one by clicking on the Register link at the top of the page. Registration is free and only takes a few moments. This requirement helps to prevent spam and allows you to track your changes over time by recording your username and the current date for each change made.

 

Documentation License

 

To accept and publish wiki contributions from the community, jboss.org requires the authors to observe a simple documentation license that covers the terms and conditions of use. The text of this license is as follows:

 

All authors submitting documentation to the JBoss Wiki give Red Hat a non-exclusive right to use, reproduce, publish or republish the documentation.

 

Features

 

Along the top of each wiki page are a number of links that provide useful functionality:

 

Home

About

Search

Changes

Unused Pages

Undefined Pages

Index

License

 

  • Home - takes you to the main wiki page.

  • About - gives a brief overview of the JBoss Wiki.

  • Search - allows you to search the wiki and the jboss.org site for relevant pages.

  • Changes - lists all of the changes made to the wiki in the last 30 days (or since the wiki began if requested).

  • Unused Pages - lists all of the pages that are not linked to (and therefore hard to find).

  • Undefined Pages - lists all of the links to wiki pages that have not yet been created.

  • Index - presents an index of all the wiki pages.

  • License - displays the documentation license that applies to all wiki contributions.

 

Adding a page

 

Wiki names

 

Editing a page

 

TextFormatting rules

Mention that there is a page called the sandbox in each wiki so that you can experiment with the editing features:

 

JSPWiki Sandbox

 

Variables

 

Attachments

 

Deleting a page

 

Watching for wiki changes using RSS

 

Wiki Etiquette