STC India’s 15th Annual Conference
October 11-12, 2013
The Zuri White Sands, Varca, Goa
Some of the sessions scheduled for the conference are listed below. Details about other sessions will be published later.
Web analytics for technical communicators
Samartha Vashishtha, Vikrant Rai – Adobe Systems
A solid foundation in Web analytics helps technical communicators prioritize and optimize content delivery. In this session, we will demonstrate how you can gain insight from the numbers you derive using Web analytics tools. We will discuss Web analytics terminology, tools, strategies, case studies, and techniques that you can start using as soon as you get back to work.
Defining and controlling scope for technical documentation
Latha S – Alcatel-Lucent
For any project, defining the scope and setting clear expectations are two major success factors. This presentation focuses on the importance of scope management in technical documentation by sharing some of the mechanisms that have been proven successful. These include defining boundaries to establish what is in scope and out of scope, the methods used in the industry to arrive at, verify, and control the scope, reprioritization of tasks, and the advantages of clearly defined expectations.
Documenting cloud operations policies, practices, and standard operating procedures
Gururaj BS – Oracle
DevOps is the blending of tasks performed by a company’s application development and systems operations teams. For a cloud service provider, DevOps documentation is critical to the success of the cloud business and a prerequisite for third-party audits and security reviews. This presentation discusses the best practices for producing such operations-oriented documentation, including policies, practices, and standard operating procedures, in a public or private cloud environment.
Technical consistency – solving an age-old documentation challenge
Tamara Ferris, Prasad Tadas – Juniper Networks
For a single document, feedback varies across customers: some topics have more technical depth than others, despite writers adhering to the same style guides and using the same tools. In this session, we look at the reasons for inconsistency in technical documentation and a solution: Knowledge Requirements. This solution aims at providing readers with consistent technical depth and expanse across each document. The presentation includes practical templates of Knowledge Requirements for a solution document and a network interfaces document that you can use. It also includes a step-wise plan for implementing an information conformance system in a company.
Journey to DITA
Mayur Agrawal – Tibco
TIBCO embarked upon a journey to align its product documentation with content reuse and topic-based authoring. Coming from a traditional approach to writing, shifting to DITA has been a long and eventful journey, yet well-marked. This session talks about the journey, the roadblocks and their solutions, and some pointers you could use if you’re planning a shift to DITA.
Augmented reality in technical documentation
Namrata Havaldar, Venkatesh Prasad – Alcatel-Lucent
One of the most talked about trends today, augmented reality is a live view of a physical, real-world environment in which elements are augmented by computer-generated sensory inputs such as sound, video, graphics, or GPS data. This session talks about augmented reality in technical documentation: how it could be a potential tool in delivering demonstrative and interactive technical content, such as installation and troubleshooting directly to user location.
Minimalism with Miffy
Mugdha Kulkarni – Tibco
Dick Bruna, the creator of Miffy (the rabbit), practiced minimalism without labeling it so. In this interactive session, Miffy helps writers get acquainted with minimalism. After the session, the participants will not feel daunted by minimalism. They will look at it as a creative approach that makes their content friendlier. The session also emphasizes on how the brain works differently when practicing minimalism and discusses the strategies for implementing minimalism at a team level and at an individual level.
Computer games and technical communication
This session shows technical communicators to think about gaming in a new way. To that end, we willexamine the relationship between computer games and the discipline of technical writing. We will look at the types of documents that support computer games andthe documentation practices in the computer gaming industry. We will also discuss how globalized production and circulation of computer games affect documentation practices and the possibility that games can be used to teach a procedural approach to complex documentation activities.
The art and science of infographics
Faraaz Mohiuddin, Vimal Chhutani – ADP
This session explores the world of infographics. We begin with the genesis, importance, and areas of implementation of infographics and then look at contemporary usage and best practices. It also looks at how one can design an infographic and the skills, tools and methods involved.
From hallucination to a vision
Ganesh Subramanian, Lakshmi Jois – Unisys
How we make the information available to the users only when it is required and provide it in a way that suits the needs of the user? This question triggered a team of information developers to set out on a journey to define the attributes of such an information system. This session talks about how the team came together, traversed a journey of challenges, and translated mere thoughts into reality.
The fine art of managing documentation reviews
Kumar Dhanagopal – Oracle
As technical communicators, we are responsible for delivering information to help the users, but the ownership of our documentation is shared with the reviewers. Unfortunately, documentation reviews typically suffer from some challenges. This presentation looks atsuchchallenges, discusses the underlying reasons, and explores specific techniques and strategies to overcome these challenges. The presentation includes examples and case snapshots based on real-work situations.
Documenting for open source
Aakanksha Singh, Nilam Shendye – Red Hat
This session presents an overview of open source with a focus on documentation. We will look at the process of documentation followed in an open source environment and the tools and technology used. We will also discuss the challenge of adapting documentation needs in such a rapidly changing software development environment.The session concludes with free resources foraudio and video clips you can use without copyright infringement or plagiarism.
Going the DITA way
Abigail Samuel, Alka Acharya – IBM
DITA is an open standard that has evolved over the years and is evolving with time. Many organizations are keen to adopt DITA but have a lot of legacy documentation and are unsure of how to manage that while transitioning to a new paradigm. In this presentation, we share our experience and the lessons we learned while migratingour massive legacy documentation to DITA: what was the overhead? What tools did we use? What are the skills required? The presentation includes practical insights and to-do checklists for an easier and a successful migration to DITA.
Action! Making instructional movies
Vikrant Rai, Girish Mehta – Adobe Systems
Videos or video tutorials are very effective in technical communication. They provide a faster and easier learning experience for the users and keep them engrossed. While creating movies and tutorials is easy for software products, for other industries, such as hardware and engineering, technical communicators need to sit on the director’s chair, wield a camera, and become a complete movie production house. This session will take you through, shooting, recording, editing, and producing a video tutorial by way of a demonstration. To show you how easy it is to create a video, we will shoot a video and edit it during the session.
Beginning your career as an independent writer
Rajshree – TechWritingLabs
You absolutely love technical writing and are thinking about going solo. What does it really take to be an independent technical writer? Drawing from my personal experiences on becoming a freelance writer and setting up my own boutique content development firm, I will share some practical tips on topics such as the pros and cons of being an independent writer and how you can have an enriching career in technical writing while being your own boss.
Applying use case principles to enterprise product documentation
Pradeep Venkateshlu – HP
Use cases help us understand our customers better and provide them the documentation that best meets their needs. It also helps us understand the customer behaviour and expectations while using the latest and greatest technologies like mobile and social media. This understanding helps us to proactively adapt to these technologies during the entire documentation life cycle. It gives us an opportunity to understand new tools available in the market for authoring, publishing, and delivering documentation to customers in the most efficient and fastest possible time. This session will cover how we approached defining documentation use cases for our enterprise products, how we gathered the information and finally how we are leveraging this information to architect and deliver our documentation.