Blog#

The wild west of polyglot docs sites

A polyglot docs site attempts to combine the outputs from multiple docs generators into a cohesive whole. There isn’t really a great way to do this, yet.

Vector arithmetic on docs embeddings

What happens if we embed the full text of a guide on Supabase, then subtract the embedding for “supabase”, and then add the embedding for “angular”?

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.

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.

changelog

TODO