Documentation for Agent Plugins (5.0)
This chapter describes how to create online help content for agent plugins.
User's Guide Contents
Documentation of an agent plugin should follow a certain structure to be consistent with existing user documentation, provided in Usage Engine. There is a set order of sections where the information should be presented in the following way:
Section | Description |
---|---|
Section 1 - Introduction |
|
Section 2 - Installation/ Further Info/ Setup (if applicable) | This section is optional and will specify required procedures for configuring the application as declared in the following sections. |
Section 3 - Profile (if applicable) | If there is a profile that needs configuration, it should be described before the agent configurations are described. There must be a screenshot of the GUI provided, with all the GUI items listed and described below. The items are listed in two columns with items to the left and the description to the right. Also, if applicable, suggested values or examples may be provided. If the GUI contains configurations in separate tabs, each tab must be described in its own subsection, each providing a screenshot of GUI and item listing. |
Section 4 - Agent | This section, including all subsections, are repeated for each agent in the User's Guide; Collection, Processing, Forwarding etc.
|
Section 5 - Inspection (if applicable) | If there is an inspection tool available, it should be described following the agent configuration descriptions. There must be a screenshot of the GUI provided, with all the GUI-items listed and described below. The items are listed in two columns with items to the left and the description to the right. Also, if applicable, suggested values or examples may be provided. If there is a Search option to limit the inspection, this GUI must be described in its own subsection, providing a screenshot and item listing. |
Section 6 - Example (optional) | Where the usage of an application is complex, it is sometimes helpful to provide an example of a "real" situation, including corresponding configurations. If this is necessary, the section is placed at the end of the User's Guide. |