Search results

2021 archives

  1. PDF and eBook formats available for API doc course

  2. One year later after moving to Seattle

  3. Broadcasting your meeting notes (API documentation topic)

  4. Barefoot shoes, basketball, and how to avoid recurring calf strains

  5. "The writing process"-- a new section in my API doc course

  6. HastyDocs: A new approach to keeping API documentation up-to-date, by Jarek Piotrowski

  7. Urban sprawl and car dependence -- some thoughts on solutions

  8. Write the Docs Podcast Episode 35: Docs for Developers book, with Jared Bhatti and Zachary Sarah Corleissen

  9. Presentation recording -- 'Best practices in API docs: Product overviews and getting started tutorials'

  10. The existentialism of technical writing

  11. New article in API doc course: Using Oxygen XML in docs-as-code workflows

  12. Biking and public transportation in Renton and Seattle: Solving the first-mile and last-mile problems

  13. tcworld China 2021 keynote: 'Tech comm and marketing: How to make your tech comm group more visible to those within your company'

  14. New article in API doc course: 'Ensuring documentation coverage with each software release'

  15. Sending doc status reports -- a tool for visibility and relationship building [API doc course]

  16. Recording of 'Product overviews vs. getting started tutorials: striking a balance between read-first and try-first user behaviors'

  17. Review of "Hashtag #TechComm: An Overview of Members, Networks, and Themes from 2016-2019"

  18. New sections in API doc course exploring causes for poor product overviews and getting started tutorials

  19. Five basketball strategies and how they might apply to tech comm

  20. Balancing product overviews with getting started tutorials

  21. Write the Docs Podcast Episode 34: Adding personality to documentation, with Fabrizio Ferri

  22. Five project management responsibilities of senior technical writers

  23. Trying to get back to normal

  24. Paligo: Structured Authoring and Component Content Management made easy

  25. Experiments: Leaving reviews on Google Maps

  26. 10 characteristics of ambiguous content

  27. Experiments: Will reading a physical newspaper improve the way I consume news?

  28. Experiments: What would happen if I exercised 2 hours a day?

  29. Balancing action with narration: Creating product overviews and getting started tutorials to satisfy both try-first and read-first learning modes

  30. An in-depth look at MadCap Flare 2021’s New Markdown Import Feature

  31. Finding a focus

  32. Updated API Getting Started tutorial

  33. Technical writing course Q&A -- 'Become a Technical Writer', with Bobby Kennedy

  34. Updated Stoplight tutorial

  35. Switching from Skype to Zoom for podcasting tools

  36. Videocast: Micro content and Flare -- Conversation with Kate Schneider

  37. Updated glossary article with technical examples [API doc course]

  38. My life story, or reflections on what shaped my life's career trajectory

  39. Analyzing doc portals by looking at developer journeys -- recommended podcast episode from Cherryleaf

  40. Who can make documentation requests

  41. Some good decisions and minor mistakes

  42. 10 observations after using my API documentation checklist in a real scenario

  43. Adding last modified timestamps to content

  44. Product overviews -- a tricky space where documentation and marketing overlap

  45. Q&A about Xeditor -- online XML editor -- with founder Matthias Kraus

  46. Write the Docs Podcast episode 33: Simplified user interfaces, with Anton Bollen

  47. Site analytics for 2020 -- trends, reflections, and thoughts

  48. Measuring documentation quality -- a rubric for developer docs

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.