Tom Johnson
Stay updated with best practices for technical writers. Includes an API documentation course for technical writers and engineers learning how to document APIs. The course includes sections on what an API is, API reference documentation, OpenAPI specification and Swagger, docs-as-code publishing and workflows…
- Popular posts
- 3
- Total points
- 769
- HN comments
- 326
- Rank
- #3,047 personal
Visit idratherbewriting.com → On Hacker News Jun 2022 – Nov 2023
Life, Learning & Writing 3Society, Policy & Culture 1Career & Management 1AI & Machine Learning 1
My experience trying to write human-sounding articles using Claude AI
You can use AI tools like Claude to help you write full-length content. By going paragraph-by-paragraph, you can direct the AI while seemingly maintaining your own voice and ideas. However, despite my attempts to use AI with writing, I’ve found that it’s harder to pull off than I thought. I can get close, but due to…
How to avoid being a secretary for engineers (2018)
If we just see our task as documenting solutions that engineers have solved, it removes the creativity and critical thinking dimension from tech comm. The creative dimension in tech comm comes into play as we identify and solve tech comm challenges, such as devising ways to simplify complexity or otherwise improve the…