technicalwriting.dev

Field notes from the frontier of technical writing.

Blog posts:

• FAQs
• word2vec-style vector arithmetic on docs embeddings
• Understanding task types in the Gemini Embedding API
• Notes on Sphinx’s built-in search
• Export Google Analytics data to Sheets via Apps Script
• Automating code deletion with Gemini (and a little Python)
• The good, the bad, and the ugly of managing Sphinx projects with Bazel
• A tutorial on managing Sphinx projects with Bazel
• Assumptions
• The intractable challenges of technical writing
• Focus on decisions, not tasks
• Exploring the intertwingularity of a docs site
• Deeplink to specific PDF pages
• Link text automation in Sphinx