Platform Migration: MkDocs to Astro

Observation

Long-form technical writing can sometimes have a friction problem: there’s typically a ton of useful information available about a topic, but not every reader wants or needs the same level of explanation.

Tooltips can help with this issue by providing further context or definitions without breaking the flow of the main text. The old Field Station was built on MkDocs; it’s a solid Python-based documentation tool, but it treated every page as a flat, static document (i.e., no tooltips - or at least, not that the author could get working, which amounts to the same thing.)

System Update

The site migrated to Astro, a modern web framework that supports MDX — meaning plain markdown text files can now include interactive components. Voila, tooltips.

The Takeaway

Choosing the right publishing tool isn’t just an engineering decision — it’s a design decision about cognitive load. When the technology gets out of the reader’s way and provides context in-flow, it stops being mere infrastructure and starts enhancing the reading experience.