Be consistent in verb tense when naming outline items.
Create the outline even if it has not been finalized. You can always go back and rename and reorganize outline items.
Avoid using special symbols such as &, $, *, and so on when naming modules, section, and topics since they may cause problems when publishing.
Create an audio script if you intend to record sound at the same time you record the steps.
Before You Record
Test the steps of the task to make sure you have all the steps and adequate test data.
Test the data before you record it and make sure it works. This helps prevent errors in your topic.
Make sure you set up the target application at the correct screen for the beginning of the topic. This may include logging out and logging in again to clear any “sticky” data.
If recording sound at the same time, check your sound and microphone recording levels and settings.
As You Record
Until you are comfortable recording, you may want to change the recording mode to manual so that the Recorder does not capture incorrect actions and screenshots. You can change the recording mode in the Recorder category in the Options dialog box.
Go slowly when you are recording to be sure that the Developer has had time to read the objects on the screen completely and the screens in the application have a chance to refresh.
Make sure that the step you want to record is showing in the Next screenshot records area of the Recorder window before you press PRINTSCREEN.
Make sure that the action displayed in the Last recorded event area of the Recorder window accurately reflects the action you wanted to record. If it does not, click the Undo button in the Recorder window and re-record the action.
If you are not sure, record the action. It is easier to delete extra frames than insert ones that you missed.
After You Record
Immediately preview the topic in Try It! mode before you add attachments, bubble text, Introduction/End frame text, and so on. If you discover errors and have to re-record the topic, you do not lose a lot of extra work.
Listen to the recorded sound for each frame.
Editing Content
You cannot move (drag and drop) a frame in the Frame Structure window in the Topic Editor so make sure you insert it in the right place. However, you can move and copy frames within a topic and from topic to topic.
Be sure you know on which frame an Alternative Path starts and ends. However, if you choose the wrong end frame, you can change it.
Fonts and Colors
You can create styles in style sheets and use those styles for a consistent appearance. You can also create separate print styles in a style sheet to modify to produce a better print appearance. If you publish documents using the Developer Settings option for web pages, the printed output uses the styles in the style sheet linked to the content instead of the settings in the print template.
If you are not using style sheets to format web pages, you can publish documents using the Word Template settings. When you publish with Word Template settings, changing the defaults in the Developer has no effect on the text fonts or colors for the printed outputs. If you want to change them, you should customize the PrintTemplate.docm file in the Styles folder for the appropriate print output. See Customize Document Formats in the Publish Content chapter for more details.
Multi-user Considerations
When working in a multi-user installation, be sure to check in your checked out documents so that they are under version control and available to other authors. Before leaving on a vacation, check in all of your documents.
If you need to work on a portion of an outline, only check out those documents that you need to edit.