General Translation blog

The docs redesign, in three posts

The posts as they ran on generaltranslation.com, kept here with their sources: the content rewrite for humans and agents, the interview with the creator of Fumadocs, and the design principles behind the redesign. Every illustration in them is on the graphics page, and the toolchain that made them is in the repository.

  1. Designing docs for humans

    Why design still matters in the age of AI and our docs design principles to clean up mental clutter.

    Kevin Liu, Taylor Fang

  2. Rewriting our docs for humans and agents

    How we designed the reading experience with a 13,000-word style guide and structured docs for agent-readability.

    Taylor Fang

  3. Fuma Nama: The philosophy of an open-sourcerer

    Why Fuma Nama believes in less abstraction, less opinionated software, and a beautiful reader experience.

    Taylor Fang