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.

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

Strengths and weaknesses of orchestrating Sphinx projects with Bazel.

Orchestrate Sphinx projects with Bazel§

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

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.