79 episodes

Topics and issues for technical writers. Improve your technical communication role. Empower users with better documentation.

I'd Rather Be Writin‪g‬ Tom Johnson

    • Education
    • 4.5 • 10 Ratings

Topics and issues for technical writers. Improve your technical communication role. Empower users with better documentation.

    The story behind Document360 -- podcast with founder Saravana Kumar

    The story behind Document360 -- podcast with founder Saravana Kumar

    In a , I explored how , a new cloud-based documentation platform, handles API documentation scenarios. This time, I decided to record a podcast with Saravana Kumar, founder of Document360, to get the behind-the-scenes story about how Document360 came about, what's driving their fast pace of development, and their roadmap for the future.

    • 32 min
    Playing a product design role as a content designer -- podcast with Jonathon Colman

    Playing a product design role as a content designer -- podcast with Jonathon Colman

    In this podcast, I chat with Jonathon Colman about an innovative work model they implemented at Intercom with content designers. In their experimental model, content designers were allocated to one project only, and they expanded their roles to include not only content design but product design as well. These content/product designers engaged on a deeper level to help products succeed.

    • 46 min
    A tip for doc reviews -- bring a list of questions

    A tip for doc reviews -- bring a list of questions

    Although doc reviews are a central part of the tech writing process, it's often a challenge to get teams to review docs. One tip is to bring a list of questions to the doc review. This provides more structure and focus to the review meeting.

    • 8 min
    Writing productivity tip: Focus sessions

    Writing productivity tip: Focus sessions

    I'm trying out a new writing productivity tip that seems to be working fairly well for me: focus sessions. A writing focus session is a one-hour session focused on a writing task. I made a goal last week of doing four writing focus sessions (at work) each day. I figured I should at least be able to devote half of my work day as a professional technical writer doing writing. This technique has boosted my writing productivity recently.

    • 8 min
    Developer portal strategies for complex landscapes -- conversation with Kristof van Tomme

    Developer portal strategies for complex landscapes -- conversation with Kristof van Tomme

    Recently I chatted with Kristof van Tomme, CEO and co-founder of Pronovix, about a topic that's become increasingly relevant in the past several months: how to deal with complex, rapidly evolving landscapes. Specifically, we focus on developer portal strategies that involve finding a balance between constraints and flexibility. Too many constraints reduces your ability to adapt to uncertain changes that might require innovative, unknown solutions. Too much flexibility might not lead to any coherent, overarching story about how to use your APIs in an integrated way toward a business goal.

    • 52 min
    API the Docs recording: How Trends in API Documentation Differ from other Tech Comm Trends

    API the Docs recording: How Trends in API Documentation Differ from other Tech Comm Trends

    I recently presented a session at the on Wednesday, May 27, 2020, as part of the . My session covered dev doc trends, and another session covered API design. A recording of my presentation is available below.

    • 32 min

Customer Reviews

4.5 out of 5
10 Ratings

10 Ratings

Tudorlyn ,

Good for tech writers, IAs and help developers

I was hesitant to be the first to review. I stumbled on this podcast while looking for "content" and "information architecture" topics. These are well organized, thoughtful and interesting. Am downloading more as I post this...

Top Podcasts In Education

Listeners Also Subscribed To