technicalwriting.dev

Field notes from the frontier of technical writing.

Topics and blog posts:

• Artifical intelligence
  • Agents
  • Embeddings
• Analytics
  • Export Google Analytics data to Sheets via Apps Script
• Automation
  • Automating code deletion with Gemini (and a little Python)
• Links
  • Link text automation in Sphinx
  • Exploring the intertwingularity of a docs site
  • Deeplink to specific PDF pages
• Sphinx
  • A tutorial on managing Sphinx projects with Bazel
  • Assumptions
  • The good, the bad, and the ugly of managing Sphinx projects with Bazel
  • Notes on Sphinx’s built-in search
• Strategy
  • The intractable challenges of technical writing
  • Focus on decisions, not tasks
  • FAQs