The Not-Boring Tech Writer

Follow The Not-Boring Tech Writer
Share on
Copy link to clipboard

In each episode of this podcast we talk to the humans behind the docs, sharing stories, experience and expertise to inspire, entertain, and give you knowledge and skills you can use in your life as a Not-Boring Tech Writer.

Jerrard Doran


    • Jun 14, 2021 LATEST EPISODE
    • infrequent NEW EPISODES
    • 33m AVG DURATION
    • 42 EPISODES


    Latest episodes from The Not-Boring Tech Writer

    Tech Writer Advocacy and Managing Write the Docs with Swapnil Ogale

    Play Episode Listen Later Jun 14, 2021 37:30


    In this episode I'm talking to Swapnil Ogale, a Technical Writer Advocate for Redocly based in Melbourne, Australia, who is also a Community and Conference Manager for Write the Docs. He gives us the inside scoop on arranging Write the Docs conferences both in-person and online, and talks to us about the importance of advocacy for technical writers. The Not-Boring Tech Writer - feedback survey Twitter - Swapnil Ogale LinkedIn - Swapnil Ogale Write the Docs

    Documentarians for Diplomacy: Bringing the Mirth with Kat Stoica Ostenfeld

    Play Episode Listen Later May 7, 2021 50:43


    We're back after a short and unexpected break! Sorry to keep you waiting! This episode you'll hear Kat Stoica Ostenfeld, an accomplished tech writer living in Copenhagen in Denmark. A linguist by credential, she says diplomacy is the key to being an effective documentarian, and shares how her translation and applied linguistics background helped her find common understanding and success in the world of technical writing. Additional topics: Beautiful limestone buildings; puppy chat; spouse sacrifices; documentation as its own pillar; language proficiency vs successful communication; the meaning of “documentation”; linguistics applied; the diplomacy of being a tech writer; full stack teams; writing rage; linguistic detective work. The Not-Boring Tech Writer - feedback survey Twitter - Kat Stoica Ostenfeld LinkedIn - Kat Stoica Ostenfeld Medium - Kat Stoica Ostenfeld Write the Docs Tekom Kat's talk from WTD Sweden 2020

    Marrying skillsets and existential googling with Caity Cronkhite

    Play Episode Listen Later Mar 19, 2021 36:11


    In this episode, I'm excited to be speaking to Caity Cronkhite, Seattle-based founder and CEO of Good Words LLC... We talk about her experience of starting up as a tech writer both in-house and freelancing, before starting and growing her own successful business in the technical writing industry, and the successes and struggles of operating Good Words LLC in these strange and unpredictable pandemic times. Additional topics: U-Haul montage; Something Big and Impactful; (not) going the way of the startup; nurturing your network; adult, painstaking colouring. Good Words LLC Email Good Words LLC LinkedIn - Caity Cronkhite LinkedIn - Good Words LLC Society for Technical Communication The Not-Boring Tech Writer

    How to Infiltrate a Hackathon in Iowa with Philip Kiely

    Play Episode Listen Later Feb 16, 2021 46:22


    This week we're speaking to Philip Kiely - author of 'Writing for Software Developers' - about being a first-time author, adventures in Budapest, and how to infiltrate a hackathon during a blizzard!  Philip's website: https://philipkiely.com/ TNBTW website: https://www.thenotboringtechwriter.com/ TNBTW Twitter: https://twitter.com/notboringtech 

    A Fond Farewell (Yet Warm Welcome!)

    Play Episode Listen Later Jan 3, 2021 82:12


    The KnowledgeOwl crew joins longtime host Jacob Moses to discuss their acquisition of The Not-Boring Tech Writer podcast, including why Jacob started the podcast, how the podcast has evolved, and what listeners can expect for the future.

    Skill #36: Creating Usability Tests for Your Organization

    Play Episode Listen Later Nov 3, 2020 46:41


    Mariana Moreira—Technical Writer at Zup Innovation and Community Manager at Brazil's budding tech writing community, Tech Writing BR—shares how you can begin creating usability tests for your organization.

    Skill #35: Understanding Basic Design Principles

    Play Episode Listen Later Sep 30, 2020 40:29


    Laci Kettavong—Marketing and Member Coordinator at Stoke—shares how you can understand basic design principles to improve your documentation.

    Skill #34: Crowdsourcing Technical Communication

    Play Episode Listen Later Feb 27, 2020 37:03


    Dr. Chris Lam—technical communication professor at the University of North Texas—discusses his newest platform, Crowdsource TPC, and how you can use it to find insights and resources to advance your career.

    Skill #33: Getting Started with Open Data

    Play Episode Listen Later Feb 10, 2020 43:25


    Open data advocates Jesse Hamner and Kyle Taylor how technical writers can use their skills to get plugged into the Open Data movement.

    Skill #32: Understanding Translation and Localization

    Play Episode Listen Later Jan 26, 2020 31:02


    Mike McDermott—Director of Language Translations at MadTranslations—shares how organization can have a seamless, successful translation process, including how to research the right translation service, who to get involved in the research process, and how to create content optimized for translation. 

    Skilll #31: Choosing the Right Knowledge Base Software for Your Organization

    Play Episode Listen Later Jan 20, 2020 50:08


    Kate Mueller—Support Sorceress and Cheese Monger at KnowledgeOwl reflects on her career to share the criterion you should consider as you choose the right knowledge base for your organization, including how to get started in your research, how to get company buy-in, and which essential features you should look for in a knowledge base. 

    Skill #30: Landing a Tech Writing Internship

    Play Episode Listen Later Nov 30, 2019 34:50


    German tech writer Joachim reflects on his past six weeks in his tech writing internship to share skills and lessons learned to help prospective tech writers land a tech writing internship.

    Skill #29: Understanding Your Reader (as a Whole)

    Play Episode Listen Later Nov 18, 2019 35:15


    Alexander Yant shares how you can understand your readers as a whole, including why empathy is one of the most important aspects of audience analysis, how tech writers can boost their audience analysis skills, and how effective audience analysis can demonstrate your value as a tech writer.

    Skill #28: Researching as a Tech Writer

    Play Episode Listen Later Oct 31, 2019 27:35


    Margaret Eker—technical writer at Magento, an Adobe company—shares how you can boost your researching skills as a tech writer, including how tech writers traditionally research new features, why tech writers should research the domain in which they work, and which steps you can take today to boost your research skills. 

    Skill #27: Contributing to GitHub

    Play Episode Listen Later Oct 24, 2019 25:38


    Tad Dieken—tech writer at Accuray—shares how to get started contributing to GitHub, including how to find projects that interest you, how to overcome imposter syndrome in GitHub, and which new skills you may learn in the process. 

    Skill #26: Getting Started in API Documentation

    Play Episode Listen Later Oct 1, 2019 38:18


    Tom Johnson—technical writer at Amazon—shares how to get started in API documentation, including where the tech writer fits in the API documentation process, what skills tech writers need to excel at API documentation, and where to find the best resources to ramp up those skills.

    Skill #25: Nudging Users to Action Through Contextual Help

    Play Episode Listen Later Sep 24, 2019 23:13


    Kacy Ewing—soon-to-be-Brooklyn-based tech writer—shares the skills you need to excel in creating contextual help, including how to position yourself in the user experience process, how to practice your contextual help writing, and where to find the best examples of contextual help.

    Finding Your Content DNA

    Play Episode Listen Later Sep 17, 2019 29:38


    John Espirian—technical copywriter and author of the soon-to-be-released book Content DNA—shares how you can find your content DNA, including how to find your niche as a writer, how to market that niche to prospective clients, and how to use your niche to win big clients.

    Skill #23: Transitioning into Tech Writing from Very-Much-Not Tech Writing

    Play Episode Listen Later Aug 30, 2019 30:51


    Chad Sterling—Product Technical Communications Specialist at KUKA—shares how you can transition into technical writing, including where to find a tribe of technical writers, how to use your existing skills to transition into technical writing, and how to ramp up your skills to find your first gig.

    Skill #22: Using Your Detective Skills as a Technical Writer

    Play Episode Listen Later Aug 26, 2019 35:50


    Jamie Roddy—Manager of Technical Communicators who leads a team of global technical communicators—shares how you can use your detective skills as a technical writer, including which detective skills are most useful for technical writers, how to ramp up those skills, and how detective skills can help you transition into other fields within a software company.

    Skill #21: Mentoring Prospective Tech Writers

    Play Episode Listen Later Aug 19, 2019 30:14


    John Paz—Senior Content Designer at Atlassian and mentoring wizard—shares his experience mentoring prospective tech writers and how you can do the same, including how to find prospective mentees, how to foster a relationship with mentees, and how mentoring can boost your own technical writing career.

    Skill #20: Understanding Content Marketing

    Play Episode Listen Later Aug 12, 2019 28:11


    Chad Lott—content marketer at Zenreach—shares his experiences as a content marketer, plus, shares tips on how technical writers can transition into the field, including how content marketing differs from technical writing, how content marketers succeed, and how technical writers can use their existing skills to transition into content marketing.

    Skill #19: Writing for Nonprofit Organizations

    Play Episode Listen Later Jul 29, 2019 25:00


    Kathleen Franks shares how you can use your skills to start writing for nonprofit organizations, including which technical writing skills best assist nonprofits, how to use your skills to advocate for nonprofits, and how to use your skills for more than just grant writing.

    Skill #18: Embracing the Long Game of Technical Writing

    Play Episode Listen Later Jul 22, 2019 29:40


    Jody Winter—Auckland-based technical writer of 15 years—shares how you can embrace the long game of technical writing, including how to observe and respond to changes in the field, how to respond to seasons of burnout, and how to find opportunities to ramp up your technical writing skills.

    Skill #17: Branding Your Work

    Play Episode Listen Later May 30, 2019 39:40


    Ash Blankenship—founder at Acme Design—shares how you can find your unique perspective on technical writing to brand your work, including how to use content to build your brand, how to choose the right platform to build your brand, and how to build a tribe that believes in your approach to technical writing.

    Skill #16: Using Cognitive Science to Make Your Technical Writing More Interesting

    Play Episode Listen Later Mar 30, 2019 31:42


    Anne Janzer—author of Writing to Be Understood—shares how technical writers can make their technical writing more interesting. We discuss where technical writers may currently miss the mark in their writing, how technical writers can use cognitive science to make their writing more interesting, and small steps technical writers can take today to begin applying the concepts.

    Skill #15: Transitioning into Instructional Design

    Play Episode Listen Later Mar 24, 2019 21:35


    Katie Price, instructional designer at Azusa university, shares how technical writers can transition into instructional design, including what types of projects instructional designers work on, what skills you need to learn to excel in instructional design, and how to use your existing skills to transition into the field.

    Skill #14: Contributing to Open Source Projects

    Play Episode Listen Later Feb 28, 2019 27:47


    Kyle Taylor—Solutions Architect at FFW and President of a Denton-based technology nonprofit TechMill—shares with how you can contribute to open source projects, including how to choose the right project to contribute to, how to translate your contributions into your portfolio, and how to create open source documentation that developers will love.

    Skill #13: Getting Your First Job in Technical Communication

    Play Episode Listen Later Dec 12, 2018 29:32


    Thaddeus Dieken – Technical Writer at Accuray – shares how you can get your first job in technical communication, including how to effectively search for jobs, market yourself as a qualified entry-level candidate, and how to navigate the workplace. 

    Skill #12: Teaching Technical Writing

    Play Episode Listen Later Oct 30, 2018 25:51


    Kim Campbell – Professor and Chair of Technical Communication at the University of North Texas – shares how you can begin teaching technical writing, including how to develop the right skills, adopt the right mindset for teaching, and enjoy a fulfilling career in academia. 

    Skill #11: Surviving in the Dev World

    Play Episode Listen Later Oct 1, 2018 36:27


    Michal Skowron and Pawel Kowaluk – technical writers at Guidewire Software in Kraków, Poland – about how you can survive in the dev world, including how technical writers can gain trust and respect from developers and how technical writers can start learning programming languages.

    Best of 2016

    Play Episode Listen Later Jan 1, 2017 25:16


    2016 was a lovely year for The Not-Boring Tech Writer podcast. We had 10 episodes with 11 guests, covering a variety of topics that truly captured the theme of the podcast: how technical writers can break the stereotype that technical writing is a boring career. This episode includes my favorite segment from each of the 10 […] The post Best of 2016 appeared first on Jacob Moses .

    best of 2016 jacob moses
    Skill #10: Implementing Single-Source Authoring

    Play Episode Listen Later Dec 12, 2016 28:45


    Paul Stoecklein knows documentation: As Documentation Manager at MadCap the industry leader in documentation software and longtime technical writer, Paul understands what does and does not work for documentation teams. A methodology that Paul believes is essential for documentation teams is single-source authoring: to use a single-source of documentation for multiple outputs. In this episode, Paul shares […] The post Skill #10: Implementing Single-Source Authoring appeared first on Jacob Moses .

    Skill #9: Creating a Human Connection in Your Documentation

    Play Episode Listen Later Oct 7, 2016 19:37


    We've all read (and perhaps written) a boring document: the robot-like language, the walls of text. And we're all familiar with the result: a disengaged reader who's likely missed the message. Enter John Espirian, freelance technical writer and Director at the Society for Editors and Proofreaders. John believes the difference between a boring and a not-boring document […] The post Skill #9: Creating a Human Connection in Your Documentation appeared first on Jacob Moses .

    Skill #8: Acquiring the Three Types of Knowledge Tech Writers Need to Succeed

    Play Episode Listen Later Aug 2, 2016 38:01


    Knowledge as technical writers, it's one of our greatest assets. However, amid the information overload technical writers often face, it's also one of the most difficult assets to acquire. Enter Tom Johnson and Lisa Meloncon. Today's guests and tech comm. advocates that have graciously shared how you can filter the information overload and shift your focus […] The post Skill #8: Acquiring the Three Types of Knowledge Tech Writers Need to Succeed appeared first on Jacob Moses .

    Skill #7: Preparing for the Future of Tech Comm

    Play Episode Listen Later Jul 9, 2016 29:07


    As the tech comm industry develops, technical writers must embrace a sobering truth: As Dr. Stan Dicks writes in Digital Literacy for Technical Communication, “Technical communicators who add value to their organizations do not merely write and edit documents.” So how do we prepare for the future of tech comm so we can ensure we're […] The post Skill #7: Preparing for the Future of Tech Comm appeared first on Jacob Moses .

    Skill #6: Bridging the Gap Between Documentation and Support

    Play Episode Listen Later Jun 28, 2016 24:38


    Documentation and Support teams share a common goal: to give customers the information they need to get the greatest value from a product. But despite a shared goal, consistent communication rarely follows. The result: tech writers missing out on content-rich customer feedback, thus, as our guest Neal Kaplan phrases it, “creating documentation in a vacuum.” In […] The post Skill #6: Bridging the Gap Between Documentation and Support appeared first on Jacob Moses .

    Skill #5: Getting Involved in a Community

    Play Episode Listen Later May 19, 2016 33:12


    We've all experienced the joy of community: colleagues mentor you; friends encourage you; strangers point you towards their favorite pizza shop downtown. For that moment, whether you had previous ties to each other or not, you feel that sense of community. And while every community is unique, one concept is constant: As urbanist Charles Montgomery defines it, “people gathering, talking, and helping […] The post Skill #5: Getting Involved in a Community appeared first on Jacob Moses .

    Skill #4: Understanding UX Design

    Play Episode Listen Later May 16, 2016 25:00


    Where should user experience (UX) design fit in the technical writer's toolbox? Well, think about how your users experience your documentation: Are they following a workflow path, following a series of pages to complete a series of tasks sequentially? Are they following nav links, jumping around to find task-specific information? Understanding how your users experience your documentation […] The post Skill #4: Understanding UX Design appeared first on Jacob Moses .

    skill ux ux design jacob moses
    Skill #3: Creating Just-in-Time Documentation

    Play Episode Listen Later May 9, 2016 30:05


    Face it: sometimes, documenting software can be tricky. Not because we don't understand the software we get that. Nor because we can't articulate it in layman's terms we've got that covered, too. But because feature guides the traditional style of software documentation isn't enough to ensure your end users can find the information they need […] The post Skill #3: Creating Just-in-Time Documentation appeared first on Jacob Moses .

    skill documentation jacob moses
    Skill #2: Transitioning from Tech Writing to Marketing

    Play Episode Listen Later Mar 16, 2016 23:13


    What's the ultimate stereotype of technical writers? Easy: that once you begin your career as a technical writer, you're caught in a documentation vortex. And worse that there's no way out. But just like all stereotypes, they're meant to be broken. As communication experts, our skills analyzing an audience; writing crisp, clear, concise copy […] The post Skill #2: Transitioning from Tech Writing to Marketing appeared first on Jacob Moses .

    Skill #1: Applying Empathy to Your Audience Analysis

    Play Episode Listen Later Mar 1, 2016 22:22


    Claim The Not-Boring Tech Writer

    In order to claim this podcast we'll send an email to with a verification link. Simply click the link and you will be able to edit tags, request a refresh, and other features to take control of your podcast page!

    Claim Cancel