Technical Documentation *Passing the baton*

577 views

Published on

I spoke on *Passing the Baton* during STC India Annual Conference 2011 in Chennai.

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
577
On SlideShare
0
From Embeds
0
Number of Embeds
22
Actions
Shares
0
Downloads
0
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Technical Documentation *Passing the baton*

  1. 1. Baton! Or Legacy? Baton!Vinish GargSTC India Annual Conference 2011, Chennai. 03 December 2011
  2. 2. Passing The BatonWe shall talk about• The Focus is on…• Next Generation: What we expect…• The Disturbing Sign: Beginners…• The Unfortunate Sign: Experienced professionals• Two Manuals: Perspective• Our Responsibility: The Wholeness• The Challenge Vinish Garg STC India Annual Conference 2011, Chennai. 03 December 2011
  3. 3. Passing The BatonThe Focus Is On • Usability • XML Basics • Localization • Subject-Verb Agreement Vinish Garg STC India Annual Conference 2011, Chennai. 03 December 2011
  4. 4. Passing The BatonNext Generation: What We Expect and Foresee• Technical Expertise• Documentation Standards and Process• Ambitious and Visionary Respect and Pride of being in Community Vinish Garg STC India Annual Conference 2011, Chennai. 03 December 2011
  5. 5. Passing The BatonThe Disturbing Sign: Beginners• Social Media Requests• Emails• CVs• Respect? Disrespectfully Yours and No Regards Vinish Garg STC India Annual Conference 2011, Chennai. 03 December 2011
  6. 6. Passing The BatonThe Unfortunate Sign: The Experienced ProfessionalsTwo professionals Pro1 and Pro2: Each with 4-5 years of experience astechnical writers, for global companies… Pro1 Pro2 < –––– Hope Seeks feedback Retaliates Despair –––– > Vinish Garg STC India Annual Conference 2011, Chennai. 03 December 2011
  7. 7. Passing The BatonThe Unfortunate Sign: The Experienced ProfessionalsPro1 Welcomes feedback• Inconsistent Spacing: No use of ‘Styles’ or ‘Paragraph space’• Contact No.: Contains Email also• Text Alignment: Justified text for all paragraphs• Inconsistent Punctuation (use of full stop in lists)• Inconsistent Alignment of Bullets in Lists• The text in tables looked bad (font, format, layout, structure)• And so on. Thanks. Vinish Garg STC India Annual Conference 2011, Chennai. 03 December 2011
  8. 8. Passing The BatonThe Unfortunate Sign: The Experienced ProfessionalsPro2 Retaliates• Applied for a position three times in eight months• I responded politely this time• Pro2 responds to my email as: Vinish Garg STC India Annual Conference 2011, Chennai. 03 December 2011
  9. 9. Passing The BatonUser Manual A, developed by Pro1• The Joy• Pleasure• Process• Fulfillment• Pride • The Journey has been Enriching • The experience is fruitful Vinish Garg STC India Annual Conference 2011, Chennai. 03 December 2011
  10. 10. Passing The BatonUser Manual B, developed by Pro2• Usability is fine• Format is acceptable• Meets requirements• Process adhered The SOUL is Missing  Vinish Garg STC India Annual Conference 2011, Chennai. 03 December 2011
  11. 11. Passing The BatonOur Responsibility Is To Ensure That… Our Bigger hands match well We do not Bypass the Basics with their Smaller hands… along the way… Hence, the Balance. Vinish Garg STC India Annual Conference 2011, Chennai. 03 December 2011
  12. 12. Passing The BatonThe Wholeness… Hence, the Balance. Vinish Garg STC India Annual Conference 2011, Chennai. 03 December 2011
  13. 13. Passing The BatonThe Challenge• Challenge or Responsibility? And… We• Respect Yourself and Respect the Profession Resume• Base. Base. Base. The Process Vinish Garg STC India Annual Conference 2011, Chennai. 03 December 2011
  14. 14. Passing The BatonAbout ME• Director Operations, Technical Documentation, vhite• Published Author• Cricket Enthusiast, Avid Photographer• Chandigarh, INDIAContactEmail: vinish.garg@vhite.comCompany Website: http://www.vhite.comDisclaimers and CopyrightsThis presentation is a copyright work of vhite systems. The vhite logo is a trademark of vhite and all other graphicsused in this document are the property of their respective owners. All rights reserved worldwide. Vinish Garg STC India Annual Conference 2011, Chennai. 03 December 2011

×