UserGuideTemplate

Basic rules writing RedDeer User Guide

When you received task to create wiki User Guide section , it refers to pages under User Guide wiki page (https://github.com/jboss-reddeer/reddeer/wiki/User-Guide)

These are basic rules and principles that good user wiki section page should fulfill:

• example driven, for API specific there is javadoc
• from simple to complex - start with simple examples
• use syntax formatting and images when referring to somthing that can be shown visually
• start with simple introduction (API and usage) and follow with examples
• if page grows please split it into multiple documents so it user can find particular information quickly directly from main UserGuide page
• when it's finish please update main UserGuide wiki page

General Example

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

Specific example structure

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();