technicalwriting.dev§

Field notes from the frontier of technical writing.

word2vec-style vector arithmetic on docs embeddings§

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

Understanding task types in the Gemini Embedding API§

Should I care about the taskType parameter of the models.embedContent method?

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

Removing code from over 200 GN build files with Python and the Gemini API.

Export Google Analytics data to Sheets via Apps Script§

A tutorial that shows you how to export Google Analytics data to Google Sheets.

Orchestrate Sphinx projects with Bazel§

An end-to-end tutorial on managing a Sphinx project with Bazel.

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

Strengths and weaknesses of orchestrating Sphinx projects with Bazel.

Embeddings are underrated§

The ML technology that might end up having the biggest impact on technical writing.

Exploring the intertwingularity of a docs site§

Building a web crawler to quantify interconnected knowledge.

Focus on decisions, not tasks§

Documentation needs to help people make decisions, not just accomplish tasks.

Deeplink to specific PDF pages§

Append #page=X to your URL, where X is the page to link to.