Underestimating Information Development (aka TechComm) services has been a known issue in lots of companies. I want to share my experience in building a team of professionals, promoting your expertise within the company as well as to the clients, and setting up a collaborative environment with InfoDev experts involved. I know, this experience may be valuable to young teams who strive to prove their value and engage into the full product development workflow within the companies, and also to the established teams who are underestimated in their companies or on their projects.
2. â—Ź Head of the Information Development Office
in ELEKS Ltd.
â—Ź Proud to live in Lviv, one of the most
beautiful cities of Ukraine
â—Ź Passionate about matters concerning
content and usability
â—Ź Believe that users do read documentation
â—Ź Love winter and skiing
â—Ź Fan of impressionism in art
About me
3. Agenda
● No one reads documentation – truth or myth?
â—Ź Short case study of how we built an Information
Development Office almost from scratch.
â—Ź Things to consider when building the team
â—Ź Discoveries that dawned on me
â—Ź Top-5 lessons learned
â—Ź Plans and aspirations
5. In fact, they are smart to do so because
● You don’t target your audience
â—Ź You have hazy knowledge of your application
â—Ź Your documentation is excessive
â—Ź The major use cases are not covered
â—Ź Poor navigation and searchability
â—Ź Poor structuring and layout
6. Think about the users
when creating any type of content
on the project, and you will prove your
team that documentation is an
essential part of a great product.
7. Challenges I faced when I joined the
company
â—Ź Little or no people knew about Technical Writers
â—Ź Prejudice against Technical Writers as non-techy fellows
â—Ź Regarding Technical Writers as proofreaders of the
developers’ documents
â—Ź Little or no success stories communicated internally
â—Ź No processes and standards enforced
â—Ź Several departments doing similar job
8. Concepts substitution
Competence development
Technical Writer
vs.
Information Developer
- InfoDev basic trainings
- Knowledge Base
- Standards and processes
- Planning
Competence promotion
Integration
- Company-wide presentations about
the “new” competence
- Presentations to interested parties
- Expert talks
- Analysis of documentation on the
existing projects
- Analysis of projects without
documentation and help on starting
documentation
- “Magic pairs”
Top-priority things I did first
9. Unexpected discoveries
â—Ź Enforcing processes and standards leads to simplifying
daily workflows rather than complicating them
â—Ź If you prove your expertise and value, the team starts
perceiving you as an integral part
â—Ź Hiring right people is crucial to the team success and
development
â—Ź Never put borders between your employees and yourself
to get a highly motivated and inspired team
10. Achievements for the 2 years
â—Ź Separating as an independent structural unit within the
company
â—Ź 3x growth
â—Ź Established onboarding and mentoring processes
â—Ź Involvement on the initial project stages
â—Ź Involvement into presales activities
â—Ź Adding documentation standards to the project
development process
â—Ź Professional blog established (informaze.wordpress.com)
12. What’s next?
â—Ź Put users before documentation
â—Ź Think of the real value your documentation brings to
users
â—Ź Standardize
â—Ź Innovate
â—Ź Be integral part of the development team
â—Ź Promote yourself