UserGuideTemplate

General Rules

• from simple to complex
• example driven
• for complete API there is javadoc
• use formatting, images
• well structured, API, Implementations,
• use code hightlight and blocks
• keep page short, if growing split it into more

Some Example of API usage how it can be structured

API / Abstract

• Interface / Abstract

Implementation(s)

• Impl1
• Impl2
• Impl3

Usage

Implementation

image

Lookup for ...."

// code

Operation1

// operation code

Short notation

// code

See example below, go from simple to more complex, add whatever details that are important, focus mainly on examples with comments

API / Abstract

• Button / AbstractButton

Implementation(s)

• PushButton
• CheckButton
• RadioButton

Usage

Implementation

image

Lookup for a button with text "Apply"

Button b = new PushButton("Apply");

Click a button

b.click(); 

Short notation

new PushButton("Apply").click();