Conventions Used in the Documentation

From ADempiere
Revision as of 21:11, 7 June 2010 by MJMcKay (Talk)

Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.

<<Table of Contents

The ADempiere documentation is a collaboratively produced work with contributions from people around the world, all in an effort to help you. While enforcing a common writing style in such a large group is like herding squirrels, this particular article outlines some goals to follow in generating documentation and reading it.

In general, the standard wiki mark-up styles will be used to present information.

Pages will always have a title. You can find the page again directly by typing the title into the search tool in the left sidebar and clicking on Go. The search is case sensitive.

Pages may also have categories displayed at the bottom. You can click on the category to see a list of pages with related information.

The following templates are used to present specific information:


Note.gif Note:

A note provides additional information or highlights an important point in the text.

Caution.gif Caution!

A caution warns you of a potential problem which could be difficult to fix if it occurs.

Code samples will be presented as preformatted text.

In cases where examples are provided, entries that are to be replaced by the user are enclosed in angle brackets <like this>. For example,” <Enter your name here> is a fine contributor!”.

The terms “user”, “system administrator” and “developer” should not be taken too literarily as the distinctions are blurred. They are used largely to help categorize and group information based on the expected target audience.