Posts on Well-Shaped Words

DuckDB is a democratizing influence on data analysis and engineering.

Learning is deeper and more durable when it’s effortful.

The command line is a text-based interface, and writing is a text-based activity.

The idea for this post came from Shauna Gordon, who gave me some great tips on how to better handle math functions in Hugo.

With Hugo inline shortcodes, you calculate values and build complex, dynamic tables without ever leaving the Markdown page.

LLMs are good at processing unstructured data, like internet pages and research papers, and at generating structured output, like code and JSON files.

I was inspired by Ian Cowley’s talk at WriteTheDocs, One glossary to rule them all.

Earlier this month, I presented a talk at Write the Docs called “Graphs, not trees: a ground-up approach to fixing a docs site.”

This shortcode is mainly for acronyms and initialisms.

The Forward feature allows you to forward messages… This is one of the most common constructions in technical documents—and one of the least useful.

I approach editing with the same creed as a doctor: first do no harm.

A typical Hugo setup designates one directory for content (the text that people read) and another for presentation configuration (the logic that controls how the text is organized on the page).

When I write headings, I always consider how they’ll look in the auto-generated table of contents (TOC).

For a long time, I knew nothing about search-engine optimization.

Awesome!