Recommended Work Flow for Cheat Sheet Development

By Mike Pawlowski

Introduction

In general, cheat sheets help guide users through complex instructions. There are two types of cheat sheets: simple and composite. Simple cheat sheets are used to organize and present logical steps and sub-steps to achieve a certain task. Composite cheat sheets are used to organize and present tasks represented by simple cheat sheets to achieve a larger goal.

Depending on the complexity of the goal, users may choose to use simple cheat sheets alone or in association with composite cheat sheets. In this document, we will be developing a simple Hello World! example that makes use of simple and composite cheat sheets.

The purpose of this document is to demonstrate the recommended work flow for doing cheat sheet development using the following User Assistance and PDE tools:

  • New cheat sheet wizard
  • New simple cheat sheet wizard
  • Composite cheat sheet editor
  • Simple cheat sheet editor
  • Register cheat sheet wizard
  • Cheat sheet view

The recommended work flow for doing cheat sheet development can be summarized in the following steps:

  • Composite Cheat Sheet
  1. 1) Create
  2. 2) Edit [Again]
  • Simple Cheat Sheet
  1. 2.1) Create
  2. 2.2) Edit
  3. 2.3) Preview
  1. 3) Preview
  2. 4) Register
  3. 5) Test

1) Create a Composite Cheat Sheet

To start the New cheat sheet wizard, perform the following steps:

  • Select File > New > Other... from the main menu.
  • Select "Cheat Sheet" under the "User Assistance" category.
  • Click the Next > button.
TODO

On the next page, perform the following steps:

  • Select the "cheatsheets" folder in the tree viewer (any folder will suffice).
  • Input "helloworld_composite.xml" in the File name: text field.
  • Select the Composite Cheat Sheet radio button.
  • Click the Finish button.
TODO

The new composite cheat sheet will be opened in the Composite cheat sheet editor.

2) Edit the Composite Cheat Sheet

To edit the cheat sheet title, perform the following steps:

  • Select the root "Title" node in the tree viewer (if not already selected).
  • Input "Hello World! Composite" into the Name*: text field.
TODO

To edit the task group, perform the following steps:

  • Select the "Group" node in the tree viewer.
  • Input "Hello World! Group" into the Name*: text field.
  • Click the Introduction tab (if not already selected).
  • Input "Hello World! Group Introduction" into the associated text field.
  • Click the Conclusion tab.
  • Input "Hello World! Group Conclusion" into the associated text field.
TODO

To edit the task, perform the following steps:

  • Select the "Task" node in the tree viewer.
  • Input "Hello World! Simple #1" into the Name*: text field.
  • Click the Introduction tab (if not already selected).
  • Input "Hello World! Simple #1 Introduction" into the associated text field.
  • Click the Conclusion tab.
  • Input "Hello World! Simple #1 Conclusion" into the associated text field.
TODO

Leave, the Path*: text field blank for now.

2.1) Create a Simple Cheat Sheet

To start the New simple cheat sheet wizard, click the Path*: hyperlink.

TODO

In the resulting wizard, perform the following steps:

  • Select the "cheatsheets" folder in the tree viewer (any folder will suffice).
  • Input "helloworld_simple_1.xml" in the File name: text field.
  • Click the Finish button.
TODO

The new simple cheat sheet will be opened in the Simple cheat sheet editor.

2.2) Edit the Simple Cheat Sheet

To edit the cheat sheet title, perform the following steps:

  • Select the root "Title" node in the tree viewer (if not already selected).
  • Input "Hello World! Simple #1" into the Title*: text field.
TODO

To edit the introduction, perform the following steps:

  • Select the "Introduction" node in the tree viewer.
  • Input "Hello World! Introduction" into the Body*: text field.
TODO

To edit the first item, perform the following steps:

  • Select the "Item" node in the tree viewer.
  • Input "Item #1" into the Title*: text field.
  • Input "Hello World! #1" into the Body*: text field.
TODO

To edit the second item, perform the following steps:

  • Click the Add Step button.
  • Input "Item #2" into the Title*: text field.
  • Input "Hello World! #2" into the Body*: text field.
TODO

2.3) Preview the Simple Cheat Sheet

To preview the unsaved cheat sheet, click the Preview button.

TODO

The cheat sheet is opened up in the Cheat sheet view to the right of the editor.

TODO

Verify the cheat sheet content and save the cheat sheet by selecting File > Save from the main menu.

3) Preview the Composite Cheat Sheet

Switch back to the Composite cheat sheet editor for the "helloworld_composite.xml" file.

Note how the New simple cheat sheet wizard poplulated the Path*: field with the path to the newly created simple cheat sheet.

TODO

To preview the unsaved cheat sheet, click the Preview button.

TODO

The cheat sheet is opened up in the Cheat sheet view to the right of the editor.

TODO

Verify the cheat sheet content and save the cheat sheet by selecting File > Save from the main menu.

2) Edit the Composite Cheat Sheet [Again]

Optionally, to add another task, perform the following steps:

  • Click the Add Task button.
  • Input "Hello World! Simple #2" into the Name*: text field.
  • Click the Introduction tab (if not already selected).
  • Input "Hello World! Simple #2 Introduction" into the associated text field.
  • Click the Conclusion tab.
  • Input "Hello World! Simple #2 Conclusion" into the associated text field.
  • Repeat the following steps for a Simple Cheat Sheet:
  1. 2.1) Create
  2. 2.2) Edit
  3. 2.3) Preview
  • Repeat the following step for the Composite Cheat Sheet:
  1. 3) Preview
TODO

4) Register the Composite Cheat Sheet

To start the Register cheat sheet wizard, click the Register this cheat sheet hyperlink.

TODO

To create a new cheat sheet category, click the New... button.

TODO

In the resulting dialog, perform the following steps:

  • Input "Hello World! Category" into the Name: text field.
  • Click the OK button.
TODO

Note how the Category: drop menu is now populated with the category created in the previous step.

To complete the registration, complete the following steps:

  • Input "Hello World! Description" in the Description: text field.
  • Click the Finish button.
TODO

5) Test the Composite Cheat Sheet

To test the cheat sheet, perform the following steps:

  • Select Run > Run... from the main menu to open the Launch configuration dialog.
  • Create a new Eclipse Application launch configuration.
  • Click the Run button to launch a second instance of Eclipse.
  • Once loaded, switch to the second instance of Eclipse.
  • Select Help > Cheat Sheets... from the main menu to open the Cheat sheet selection dialog.
  • Select the "Hello World! Composite" node under the "Hello World! Category" in the tree viewer.
  • Click the OK button.
TODO

The cheat sheet is opened up in the Cheat sheet view.

TODO

Verify the cheat sheet content.

Conclusion

In conclusion, the recommended work flow for doing cheat sheet development can be summarized in the following steps:

  • Composite Cheat Sheet
  1. 1) Create
  2. 2) Edit [Again]
  • Simple Cheat Sheet
  1. 2.1) Create
  2. 2.2) Edit
  3. 2.3) Preview
  1. 3) Preview
  2. 4) Register
  3. 5) Test
Index
  • Composite Cheat Sheet
  1. 1) Create
  2. 2) Edit [Again]
  • Simple Cheat Sheet
  1. 2.1) Create
  2. 2.2) Edit
  3. 2.3) Preview
  1. 3) Preview
  2. 4) Register
  3. 5) Test