technicalwriting.dev§

Field notes from the frontier of technical writing.

word2vec-style vector arithmetic on docs embeddings§

(2025 Oct 29) Does vector("king") - vector("man") + vector("woman") ≈ vector("queen") work in technical writing contexts?

Understanding task types in the Gemini Embedding API§

(2025 May 15) Should I care about the taskType parameter of the models.embedContent method?

Automating code deletion with Gemini (and a little Python)§

(2025 Apr 29) Removing code from over 200 GN build files with Python and the Gemini API.

Export Google Analytics data to Sheets via Apps Script§

(2025 Apr 25) A tutorial that shows you how to export Google Analytics data to Google Sheets.

Orchestrate Sphinx projects with Bazel§

(2025 Mar 25) An end-to-end tutorial on managing a Sphinx project with Bazel.

Sphinx + Bazel: the good, the bad, and the ugly§

(2025 Mar 25) Strengths and weaknesses of orchestrating Sphinx projects with Bazel.

Exploring the intertwingularity of a docs site§

(2024 Oct 16) Building a web crawler to quantify interconnected knowledge.

Focus on decisions, not tasks§

(2024 Oct 15) Documentation needs to help people make decisions, not just accomplish tasks.

Deeplink to specific PDF pages§

(2024 Jul 11) Append #page=X to your URL, where X is the page to link to.