TOPIC-BASED AUTHORING What is it?
The traditional approach to producing books and manuals is to plan a content and style, and then sequentially author the information. This is easy for simple documents but where a complex series of books are to be produced, multiple editing of common information for the different volumes and variants is required.
Topic-Based Authoring is the creation of individual topics that are relevant to the potential user of a manual, series of manuals, on-line help or web page.
These individual topics can be created and edited as the procedures and details evolve, and be independently reviewed and modified when required.
When the deliverable e.g. a book or on-line help is required, a structure is created and the topics added. For example some topics may be relevant to a User Guide but others may be required in several additional associated books of a series such as Service Guides, Repair Manuals etc. and also as on-line helps. As each topic is unique, content will be the same wherever it is called for use.
Consistent character styles and document layouts are preset, enabling the topic’s presentation style to be automatically reconfigured to the format of the document in which it is used. Conditional text can be added to a topic to allow it’s use in several products or manual variants.
The end user will not see the individual topics. Only the compiled deliverable.
To summarise:
- Topic-Based Authoring focuses authoring effort on the content not the final deliverable.
- Specific books or guides are not developed individually, instead a body of useful information is authored. Relevant information will finally be selected for publication, independent of the information development process.
- Topics can be individually reviewed, a far less onerous task than reviewing a completed chapter or book.
- Content re-use is maximised and authoring time minimised. The quality of the information is higher as it is more focused.
- The final deliverables can be based on multiple current requirements, and be cheaper and easier to localise.
- Any updates will apply to all the deliverable formats.
Find out more about the potential of the software we use
http://www.madcapsoftware.com/products/flare/