#29 - A Guide to Technical Writing and Content Creation - Helen Scott

<p><em>“If a user is even reading documentation that a technical writer has produced, they’re probably already annoyed."</em></p> <p>Helen Scott is a technical writer and Java Developer Advocate at JetBrains. In this episode, we discussed many things about technical writing, such as the technical writer role definition, the traits of a good technical writer, and how to create a good technical content, including a few gotchas that a technical writer needs to be aware of. Helen also shared with me the concept of community mentoring, and how it can be helpful for the mentee, the mentor, and the community altogether. Towards the end, Helen shared some content creation and sharing tips/hacks based on her popular blog post.</p> <p>Listen out for:</p> <ul> <li>Career Journey - [00:05:46]</li> <li>Technical Writing - [00:10:48]</li> <li>Good Traits of a Technical Writer - [00:14:25]</li> <li>Elements of Good Technical Content - [00:19:59]</li> <li>Inlining Technical Content - [00:25:38]</li> <li>Examples of Good Technical Doc - [00:27:27]</li> <li>Open Sourcing Documentations - [00:29:38]</li> <li>Structure of Good Product Documentation - [00:31:31]</li> <li>Blog Posts to Attract Talent - [00:36:37]</li> <li>Community Mentoring - [00:38:04]</li> <li>Hacks for Content Creation and Sharing - [00:45:25]</li> <li>3 Tech Lead Wisdom - [00:50:24]</li> </ul> <p>_____</p> <p><em>Helen Scott’s Bio</em><br> Helen is a Java Developer Advocate at JetBrains. She has over 20 years’ experience in the software industry which has been gained in a variety of roles including developer, technical writer, product owner, and advocacy.</p> <p>Helen is passionate about the journey of learning and discovery. She enjoys challenging herself to learn new tools and technologies and sharing the highs and inevitable lows of that journey through the content that she creates.</p> <p>Helen believes that the role communication plays throughout our personal and professional lives is critical and often overlooked. She strives to put co