To perfectly support users working with software, online help should cover specific work situations and should provide the required information for current tasks with minimum search effort. The online help features some specific attributes which make them very well suited for software documentation.
Display texts on electronic devices and user interface texts are also parts of the software documentation.
The online help covers specific task contexts to give users optimum support when they are applying the software. The required information is provided via the online help in a task-oriented manner without the need to perform extensive searches. The software documentation is structured according to the tasks users have to complete. Users can access the online help via Help buttons or by using the F1 key.
Display texts on electronic devices and user interface texts are integral parts of the software documentation and must be easy to understand, consistent and correct, to ensure safe operation by the user. Developers often write these types of texts. Technical writers then sometimes review and edit these. There are rules to be observed during this process.
Users tend to read user interface texts differently than continuous texts, such as seen in the online help. They do not read from the top left to the bottom right, but rather they glance over the entire user interface and then skim the texts and the buttons. They do not read, they skim. There is another difference when compared to normal, continuous text: users tend to stop reading immediately once they have found what they are looking for.
There is often very little space to accommodate the texts. For this reason, these texts have to be rather brief, concise and consistent. Consistent labelling of buttons and other elements of the user interface are essential to ensure usability.
Message texts, confirmation dialogues and instructions shown on the user interface are in good hands with technical writers. They check whether texts are consistent and easy to understand. Fault messages should be particularly informative. They are not only used to describe the fault but also explain how the user can resolve or correct it. The same applies to user interface texts and the entire corporate content alike: the applied terminology must be consistent.
We provide the documentation for your software. Do you have any questions? We can help. As a supplier and reliable service provider, people text will work with the authoring system of your choice, to provide the documentation for your software. The creation process for your software documentation will be seamlessly integrated into your editorial processes.
You will naturally retain all rights to the created texts and source codes of all systems.