Contributing a cheat sheet¶

Contributing a cheat sheet is pretty straightforward.

1. In the help plugin sheetsheet folder create a new XML file with the name of your new cheat sheet. Example newProjectWizard.xml

2. Past this template into the file.

   <?xml version="1.0" encoding="UTF-8"?>
   <cheatsheet title="Cheat Sheet Title">
     <intro>
       <description>
           Add your cheat sheet description here
       </description>
     </intro>
     <item title="Step One">
        <description>
           Step one description
       </description>
     </item>
     <item title="Step two descriptions">
        <description>
           Add your cheat sheet description here
       </description>
     </item>
   </cheatsheet>

3. Save the file.

4. Add a cheat sheet to the org.eclipse.ui.cheatsheets.cheatSheetContent extension point and use the file you just created as your contentFile.

   <extension
          point="org.eclipse.ui.cheatsheets.cheatSheetContent">
           <cheatsheet
           category="org.locationtech.udig.help.cheatsheet.category.myCategory"
           composite="false"
           contentFile="cheatsheets/myCheatSheetContent.xml"
           id="org.locationtech.udig.help.cheatsheet.myCheatSheetContent"
           name="My Cheat Sheet">
       </cheatsheet>
   </extension>

5. Edit your cheat sheet template adding new items and actions as required. For more information on Cheat Sheet XML format see the eclipse documentation

<item
  title="New Layer Wizard"
  dialog="true"
  href="/org.locationtech.udig.help/EN/Add Data wizard.html">
    <description>
        Choose <b>File > New > New Layer</b> from the menu bar to open up the Add Data wizard
    </description>
    <action
        class="org.locationtech.udig.project.ui.internal.actions.AddLayersAction"
        pluginId="org.locationtech.udig.project.ui.editor"
        confirm="false"/>
</item>

<item
    title="Style View">
    <description>
    uDig also offers a Style View that can be utilised to preform simple layer styling.
    To see the Style View in action change to the Style Perspective by selection
    <b>Window > Open Perspective > Style Perspective</b>
     </description>
     <command
          serialization = "org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.locationtech.udig.ui.stylePerspective)"
        required="false"
        translate=""/>
</item>

Contributing a category¶

Add a cheat sheet category to the org.eclipse.ui.cheatsheets.cheatSheetContent extension point

<extension
       point="org.eclipse.ui.cheatsheets.cheatSheetContent">
    <category
          id="org.locationtech.udig.help.cheatsheet.category.categoryName"
          name="Category Name">
    </category>
</extension>

When to create cheat sheets¶

Cheat sheets are well suited to tasks which consist of steps which lead towards a tangible goal. The goal must be well defined so that the user can see success when all the steps in cheat sheet have been completed. Tutorials are often good candidates for cheat sheets, in a tutorial the goal is to learn how to perform a specific task. Cheat sheets will usually contain up to 10 steps and can be completed in a half an hour or less. For larger tasks consider using a composite cheat sheet.

When to create composite cheat sheets¶

Composite cheat sheets are used to for providing guidance through a task which is too large to describe in a single cheat sheet or which has multiple goals. A composite cheat sheet can be used when you are guiding the user over a sequence of tasks that exist in individual cheat sheets but make up a greater task. Example “Quickstart”.

When not to use cheat sheets¶

Cheat sheets work best when problem can be solved by a sequence of simple steps. Cheat sheets are not a substitute for the help system which allows for creation of HTML pages with rich graphics and random access of information using search and hyperlinks. Cheat sheets are not intended for tasks which require a large amount of text to be input by the user.

When to create a new category¶

Try to fit your cheat sheet into existing categories, if your cheat sheet doesn’t fit into any existing categories then create your own.