UI Best Practices Template v3.x

Proposed Template Revision 1

Topic Name

Title

<Content of this section includes Summary and Problem Description type information.>

Design Rationale

<This describes the thinking behind the design and the best practices to solve the problem.>

Examples

< This is a good place for Common Errors with related examples as well as Tips and Tricks its often examples, so maybe just call it examples. This makes it easier for those to contribute since design v.s. in practice is easier to explain.>

• Good example 1

• Good example 2

• Common error example 1

• Common error example 2

• Tip and trick 1

• Tip and trick 2

Guidelines

<This is a list of Do's and Dont's>

Related Information

<This is for links to related information internal or external to the guidelines and to areas of the 2.1 guidelines that your best practice extends. Provide as direct links as possible.>

Proposed Template Revision 2

Topic Name

Title

<Content of this section includes Summary and Problem Description type information.>

• Summary is a single active and concise statement describing what to do to follow the best practice. It should start with a verb.
• Problem Descriptionis short 1 – 3 paragraph description of the problem.

Design Rationale

<This describes the thinking behind the design and the best practices to solve the problem.>

Examples

<This shows good examples, common errors, and tips and tricks.>

• Good example 1

• Good example 2

• Common error example 1

• Common error example 2

• Tip and trick 1

• Tip and trick 2

Guidelines

<This is a list of Do's and Dont's>

Implementation

<This offers information for implementing the solution. It could be a link to the API code for example, or some instructions.>

• Sample code 1

• Sample code 2

Related Information

<This is for links to related information internal or external to the guidelines and to areas of the 2.1 guidelines that your best practice extends. Provide as direct links as possible.>

Current Template

Topic Name

Summary

<This is a single active and concise statement describing what to do to follow the best practice. It should start with a verb.>

Problem Description

<This is short 1 – 3 paragraph description of the problem.>

Best Practice

<This lists and describes the best practices or best practices in solve the problem.>

Tips and Tricks

<This offers tips and tricks for solving the problem.>

Common Errors

• Example 1

• Example 2

Implementation

<This offers information for implementing the solution. It could be a link to the API code for example, or some instructions.>

• Sample code 1

• Sample code 2

Related Information

<This is for links to related information internal or external to the guidelines and to areas of the 2.1 guidelines that your best practice extends. Provide as direct links as possible.>