1. Upcoming Intro to API Documentation presentation at STC Silicon Valley chapter on 11/20/2017

  2. Balancing writing, editing, and learning in equal measures

  3. New OpenAPI 3.0 specification tutorial in my API Course

  4. The Untold Story of Techwriter.pl: A Polish website about technical communication for technical writers, trainers, and translators

  5. Question: Which software tools should I use if my goal is to write API docs?

  6. WTD Episode 10: What's going on in our lives as documentarians and product owners

  7. SwaggerHub: A collaborative platform for working on OpenAPI/Swagger specification files, and more

  8. Convert Google Docs content to Markdown or HTML using the gd2md-html add-on

  9. Has plain language deepened or ruined our delight in language?

  10. Write the Docs Podcast Episode 9: Chatbots in Documentation

  11. Discoveries and realizations while walking down the Docs-as-Code path

  12. Why Stack Overflow's Documentation effort failed -- a few thoughts from a technical writer's perspective

  13. Tech docs and Agile: Alternatives to integrating into engineering Scrums (Part 2)

  14. Tech docs and Agile: Problems with integrating tech writers into engineering Scrums (Part 1)

  15. Why simple language isn't so simple: the struggle to create plain language in documentation

  16. When the pain of ignorance exceeds the pain of learning

  17. Transparency in documentation: dealing with limits about what you can and cannot say

  18. Write the Docs Podcast Episode #7: Let The Robots Do The Work

  19. Circle review -- How to manage your kids' access to Internet devices

  20. My second-chance points strategy with documentation

  21. The problem with Frequently Asked Questions (FAQs) in documentation

  22. Recording of my WTD Portland 2017 presentation on Building navigation for your doc site -- 5 best practices

  23. Write the Docs Podcast Episode #6: Metadata and UI copy

  24. Limits to the idea of treating docs as code

  25. How big should your documentation repo be?

  26. Impressions from the Write the Docs Conference -- and thoughts on achieving sustainability without selling out to vendors

  27. Slides for Write the Docs Portland presentation on doc navigation best practices

  28. Testing your documentation -- updates in API doc course

  29. Write the Docs Podcast Episode 5 -- Where do we belong?

  30. My Calm Meditation app -- another experiment to test my docs

  31. Tutorial on converting an HTML site into a Jekyll theme

  32. Following instructions involves learning a new language -- adventures with Tinker Crate projects

  33. Write the Docs Podcast app now on Fire TV, and the importance of testing your docs with sample apps

  34. Amazon begins pilot with voice-interactive user manuals

  35. Tutorials versus docs -- why you need both

  36. Moved my API doc site into separate repo

  37. Simplifying my life and writing

  38. Guest post -- The effects of terminology consistency on the reader's comprehension and attitude

  39. Crowdsourcing docs with docs-as-code tools -- same result as with wikis?

  40. Write the Docs Podcast Episode 4 -- Continuous Integration and Docs as Code

  41. Adobe FrameMaker 2017 -- time, tools, and the tech writer’s focus on content

  42. Upcoming 2017 Write the Docs Conference in Portland

  43. Guest Post -- MadCap Central: A Review for Companies Delivering Technical Communication Services

  44. How do you learn what you need to learn to be successful as a technical writer?

  45. Guest post: Design choices for organizing API reference content with other documentation

  46. Recording of User-Centered Design Principles for Organizing Documentation

  47. Write the Docs Podcast #3 - Trends for 2017

  48. Technical Writing Trends and Predictions for 2017

  49. Simplified Technical English and HyperSTE

  50. Recording: Modern Technical Writing, by Andrew Etter (STC Silicon Valley chapter)

  51. Recording: Writing tech docs like a hacker with Jekyll

  52. My top 3 posts of 2016 are all Swagger-related -- lessons learned from 2016 analytics

  53. Swagger presentation recording -- Harnessing the Chi of Swagger in your REST API documentation

  54. FrameMaker and the mobile web: Evaluating Adobe FrameMaker's responsive HTML5 output

  55. MadCap Central -- a first look at MadCap’s new cloud-based collaboration and publishing solution

  56. How much code do you need to know to create API developer documentation?

  57. Attend my upcoming TC Dojo presentation on Swagger on Jan 9, 2017

  58. TC Camp in Santa Clara to be held Jan 21, 2017

Get new posts delivered straight to your inbox.

Subscriber count: 4,039