EN 
PT-BR
FR
ES
DE
In this week’s episode of the Knowledgebase Ninjas Podcast, Gowri Ramkumar is joined by Lucía M. Polis, Principal Technical Content Writer at Qumulo. They discuss Lucía’s approach towards technical documentation, innovations in the industry, and tips on building a promising technical writing career.
Key Facts
- Lucía’s LinkedIn
- Lucía’s website
- Lucía holds a PhD degree in Literary Translation Studies from the University of Calgary
- Lucía has been associated with the technical writing industry for over a decade
- Lucía is a former Information Developer II and SAP term Superuser (Business Intelligence Suite) for SAP
- Lucía is a former Product Manager in Documentation for Hewlett Packard Enterprise
- Lucía is a former Senior Program Writer at AWS (Amazon Web Service)
- Lucía is a former Principal Technical Writer, Project Manager, and Team Lead for Oracle
Key Takeaways
- After graduating, Lucía struggled to get a job, so his father advised him to try out technical writing as an intern at his company
- Lucía loved the experience and learning he acquired as a technical writing intern
- In 2010, learning technical writing was comparatively difficult. However, Lucía was able to learn structural writing and the landscape/basics of technical writing
- During his internship, Lucía enrolled himself in several related courses to enhance his technical writing skills
- Throughout his technical writing career, Lucía has worked with renowned organizations such as SAP, Hewlett Packard Enterprise, AWS (Amazon Web Service), and Oracle
- Lucía believes that a technical writer should focus on the targeted audience and their needs while creating a document
- Lucía believes that quality documentation requires constant grooming and improvement
- Lucía shares that “communication is often misunderstood, it’s not about sharing what we have but about making the audience understand what they are looking for”
- At Qumulo, Lucía’s team takes care of a variety of content, including knowledge-based articles, release notes, support articles, and internal documentation
- Lucía discusses the difference between documentation styles at large and small companies. He believes that large companies have a relatively structured process, whereas smaller companies’ processes are mostly haphazard and require streamlining. “There is a need to create a middle way to create a life cycle that is appropriate”
- To produce high-quality documentation, writers must;
- Have product knowledge
- Understand the technical concepts
- Know about the targeted audience
- Acquire high-resolution images
- Understand the functionality and operations of the organization
- Lucía believes that including a technical writer as a core member of the team is a huge step for innovating the field. Technical writers initially were kept on the side, waiting to be included in the process. But now they are considered key members and play an important role in technical product launches. The job has a steep learning curve, and technical writers are now integrated into a series of scrums. They get to attend stand-ups and meetings and work closely with software developers – something unheard of only a couple of years ago
Lucía’s biggest influence
- Shawn McKenzie – Senior Documentation Manager, AWS Documentation
Lucía believes Shawn was the first person to teach him the term ‘technical writing’. At the time, they were using structured writing and data tracking/tagging, so there was a lot to learn and explore. He shares that it was quite overwhelming to organize technical concepts, but Shawn was the person who inspired him to follow his track.
Key resource
- I’d Rather Be Writing – Tom Johnson
- Stack Exchange
What documentation-related advice would Lucía give to his twenty-year-old self?
“Get your hands dirtier, faster”. Lucía shares that initially, he was quite shy about learning the technicalities and asking questions. “It is important to keep asking the questions to develop a better understanding of the product, which improves documentation quality”.
Subscribe to the Knowledgebase Ninjas
–