Difference between revisions of "UI Best Practices Template v3.x"

From Eclipsepedia

Jump to: navigation, search
Line 1: Line 1:
= Proposed Template Revision 1 =
+
= Proposed Template Revision =
 
== Topic Name ==
 
== Topic Name ==
 
 
=== Title ===
 
=== Title ===
<Content of this section includes Summary and Problem Description type information.>
+
<Content of this section includes summary and problem description type information.>
  
=== Design Rationale ===
+
* Description short 1 – 3 paragraph description of the problem.
<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 ===
 
=== Design Rationale ===
Line 42: Line 11:
 
=== Examples ===
 
=== Examples ===
 
<This shows good examples, common errors, and tips and tricks.>
 
<This shows good examples, common errors, and tips and tricks.>
 +
 +
(Required)
  
 
* Good example 1
 
* Good example 1
  
 
* Good example 2
 
* Good example 2
 +
 +
(Optional)
  
 
* Common error example 1
 
* Common error example 1
  
 
* Common error example 2
 
* Common error example 2
 +
 +
(Optional)
  
 
* Tip and trick 1
 
* Tip and trick 1
Line 59: Line 34:
  
 
=== Implementation ===
 
=== Implementation ===
 +
 +
(Optional)
 +
 
<This offers information for implementing the solution. It could be a link to the API code for example, or some instructions.>
 
<This offers information for implementing the solution. It could be a link to the API code for example, or some instructions.>
  

Revision as of 15:07, 3 April 2007

Contents

Proposed Template Revision

Topic Name

Title

<Content of this section includes summary and problem description type information.>

  • Description 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.>

(Required)

  • Good example 1
  • Good example 2

(Optional)

  • Common error example 1
  • Common error example 2

(Optional)

  • Tip and trick 1
  • Tip and trick 2

Guidelines

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

Implementation

(Optional)

<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.>