Download - Author-it Case Study
![Page 1: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/1.jpg)
Author-it Case Study
A successful software company with a suite of products that needs accompanying user documentation
![Page 2: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/2.jpg)
2
Computing Directions Australia• Over 20 years in business
• Flagship product is Synergetic Management System for Schools
• Software covers all functions required by a private educational institution
• 100+ customers, thousands of users
• New software includes:– Synweb– Web portal
![Page 3: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/3.jpg)
3
Evolving suite of software productsSynergetic client-server
Synergetic web application (Synweb)
![Page 4: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/4.jpg)
4
Evolving suite of software products
Synergetic web portal
![Page 5: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/5.jpg)
5
Author-it
• We use Author-it to maintain the documentation
• Author-it is a NZ software product
• Authoring and content management
• Single-source publishing to multiple outputs
![Page 6: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/6.jpg)
6
How Author-it is used
• Develop and maintain content• Publish content to different formats:
– PDF– Online help– Context-sensitive help
• Use the features of Author-it to improve the usability of the documentation
• Re-use existing content to create documentation for new products
![Page 7: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/7.jpg)
7
Develop and maintain content
• Author-it Enterprise Edition
• SQL Server database for the library
• 16,300+ objects
• Smaller projects can use a JET database
![Page 8: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/8.jpg)
8
Author-it – a database of objects
Books65
Topics2700
File objects5062
Styles90
Total 16,371
![Page 9: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/9.jpg)
9
Books and topics – organised content!• A book collects
together relevant topics
• The structure is used to generate the table of contents
![Page 10: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/10.jpg)
10
Styles – enforced rigour!• Every
paragraph must have a style!
• Character styles are useful too!
• Standard styles are available
• New styles can be defined
![Page 11: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/11.jpg)
11
File objects – graphics with attitude!• Every aspect of
a file object can be controlled
• Templates are used to inherit generic properties
• File objects can be embedded or linked
![Page 12: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/12.jpg)
12
Templates – inheritance brings speed• Templates are
special objects• Can save a lot of
time• You can easily
apply a different template to change the behaviour of one or more objects
![Page 13: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/13.jpg)
13
How Author-it is used
• Develop and maintain content• Publish content to different formats:
– PDF– Online help– Context-sensitive help
• Use the features of Author-it to improve the usability of the documentation
• Re-use existing content to create documentation for new products
![Page 14: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/14.jpg)
14
Publish output to a range of outputs• Output to:
– MS Word– HTML Help– HTML Pages
• Other outputs
• Leverage the investment in existing content
![Page 15: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/15.jpg)
15
Synergetic – context-sensitive help
![Page 16: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/16.jpg)
16
Synweb – online help
![Page 17: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/17.jpg)
17
Microsoft Word output – converted to PDFs
![Page 18: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/18.jpg)
18
How Author-it is used
• Develop and maintain content• Publish content to different formats:
– PDF– Online help– Context-sensitive help
• Use the features of Author-it to improve the usability of the documentation
• Re-use existing content to create documentation for new products
![Page 19: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/19.jpg)
19
Books65
Topics2700
File objects5062
Styles90
Total 16,371
Author-it – more objects…
File objects5062
Styles90
Media objects24
Total 16,371
Hypertext links2751
Index entries5609
Indexes34
Overall books 2
![Page 20: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/20.jpg)
20
Hypertext link – online example
![Page 21: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/21.jpg)
21
Linking to a URL – online example
![Page 22: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/22.jpg)
22
• Expanding hotspots are useful for reducing clutter online
Drop down hotspot – online output
• Expanding topic has all the features of a regular topic
• User sees what they want to see
![Page 23: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/23.jpg)
23
Useful navigation features
• Table of contents– Automatically generated from the book
structure
• Full text search facility– Automatic in all online output
• Index– Created from index entries you enter
• Glossary - optional• Table of figures - optional
![Page 24: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/24.jpg)
24
Full text search and index
![Page 25: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/25.jpg)
25
Table of contents
![Page 26: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/26.jpg)
26
Media objects• Define the formatting of
published output• For example:
– paper size and margins for printed output
– Colours and layout in HTML pages output
![Page 27: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/27.jpg)
27
How Author-it is used
• Develop and maintain content• Publish content to different formats:
– PDF– Online help– Context-sensitive help
• Use the features of Author-it to improve the usability of the documentation
• Re-use existing content to create documentation for new products
![Page 28: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/28.jpg)
28
Books65
Topics2700
File objects5062
Styles90
Total 16,371
Author-it – more objects…
File objects5062
Styles90
Media objects24
Total 16,371
Embedded topics
234
Topics2466
Hypertext links2751
Index entries5609
Indexes34
Overall books 2
![Page 29: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/29.jpg)
29
Embedded topics – Re-using content!• Synergetic and
Synweb topics use common, embedded topics (grey)
• The embedded topic can be easily edited
• A change in the embedded topic is reflected in the other topics
![Page 30: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/30.jpg)
30
Re-using content – online examples
![Page 31: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/31.jpg)
31
Summary
• Initially Author-it enabled us to:– comprehensively document the Synergetic client-
server system– publish to Word, PDF, HTML Help and context-
sensitive help– easily update screen captures as features changed.
• As CDA have grown Author-it has enabled us to:– re-use content to create documentation for new
products (web-based product, stand-alone product)– output to HTML pages (latest version on CDA website).
![Page 32: Author-it Case Study](https://reader035.vdocuments.mx/reader035/viewer/2022062518/568142a0550346895daedbc2/html5/thumbnails/32.jpg)
32
Thank you
• Contact us to discuss your unique requirements without cost or obligation:– Phone (03) 8544 1400– Email [email protected]