Your SlideShare is downloading. ×
Online help print_docs_wiki_stc_july2010
Upcoming SlideShare
Loading in...5
×

Thanks for flagging this SlideShare!

Oops! An error has occurred.

×

Introducing the official SlideShare app

Stunning, full-screen experience for iPhone and Android

Text the download link to your phone

Standard text messaging rates apply

Online help print_docs_wiki_stc_july2010

537
views

Published on

Published in: Technology

0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total Views
537
On Slideshare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
0
Comments
0
Likes
0
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
No notes for slide

Transcript

  • 1. Online Help & Print Documentation: Using Wiki By Gurpreet Singh & Suman Lata Malik Saturday, July 24, 2010 STC Regional Conference, New Delhi
  • 2. Contents
    • Traditional Approach
    • Barriers in Traditional Approach
    • Search for Future proof and Collaborative approach
    • We found it the Wiki Way!
  • 3. What we do?
    • Develop end user documentation for a fleet of 8 commercial EDA tools, updated several times in a year
    • Maintain/Develop over 1,25,000 pages of technical content, in several languages
    • Generate output in html help, chm, pdf and web accessible format
  • 4. Traditional Approach
    • Growth from one major annual release for three products to quarterly release for eight products
    • No increase in headcount
    • Unrealistic workload of over 200 books (over 30,000 pages), updated several times a year
  • 5. Traditional Approach Write Format Edit Review Index Link Generate Build Install
  • 6. Traditional Approach 65% of Time (was) Spent Formatting and Building Content
  • 7. Search for Alternatives
    • 15 million articles
    • Over 3.3 million English articles
    • Articles in 261 languages
  • 8. Search for Alternatives
  • 9. Search for Alternatives
  • 10. Search for Alternatives TWiki Confluence Mediawiki
  • 11. Confluence Wiki
    • Paid wiki (A 500-user Confluence license costs half the price of a single-user FrameMaker-WebWorks Publisher license)
    • Almost zero down-time
    • Amazingly easy to use for all tasks, from Administration to Authoring
  • 12. Moving the Mountain
    • TRANSLATE: Modified WebWorks Publisher template to generate Wiki Markup output from FrameMaker files
    • CLEAN UP: Perl scripts to further clean the output-remove double-spaces, add file names, titles, etc
    • TRANSFER: Addition of wiki-markup in respective wiki spaces
  • 13. References
    • “ Printed Books and Online Help Using a Wiki”- STC Annual Conference 2008, Philadelphia- Rahul Mehrotra
      • http://sites.google.com/site/moremiscellany/works/wiki-publishing/Printed-Books-and-Online-Help-Using-a-Wiki
    • DMOZ
      • http://www.dmoz.org/Computers/Software/Groupware/Wiki/Wiki_Engines/
    • Wiki Matrix
      • http://www.wikimatrix.org
  • 14. Thanks for attending! G urpreet Singh is a professional writer and a trainer based in New Delhi having a keen interest in Human Psychology. He works in the creative realms of Technical Writing, Business Writing (MarCom), Web-Copy Writing and Training. He can be contacted at [email_address] . More tips and information available at: http://gurpreetwrites.wordpress.com S uman Lata Malik is an experienced technical and marketing communication professional with a passion for developing and executing communication strategies for complex technical and marketing documentation efforts. She is the founder and chief consultant of Infotechwriter Documentation Services, a startup company based in New Delhi. She can be contacted at: [email_address] www.infotechwriter.asia