Blog

Posts in 2026
  • OINK implementation diary: from copied shells to one theme

    Saturday, August 08, 2026 in Blog

    OINK began with an awkward observation: several production documentation sites looked related because they were related, but their common implementation lived as copied files. The visible result was consistent enough; the maintenance model was not. …

    Read more

  • Introducing the OINK implementation preview

    Saturday, August 08, 2026 in Blog

    Today we are publishing the OINK implementation preview: a directly evolved Docsy theme with one canonical product shell, a Hugo-only consumer build, local-first browser dependencies, a general multilingual framework, and a set of reusable content …

    Read more

  • Release 0.16.0 report and upgrade guide

    Wednesday, July 29, 2026 in Blog

    Highlights First-class npm support: install Docsy from the registry, and more Favicons: drop your icons into static/ and Docsy does the rest Shared chrome (experimental): a build mode for much faster link checking of large sites Agent-ready upgrade …

    Read more

  • Hugo 0.158.0-0.164.x upgrade guide

    Tuesday, July 28, 2026 in Blog

    This post is a companion to the Docsy 0.16.0 release post, which specifies the Hugo versions that 0.16.0 requires and validates. Upgrade summary This guide is for you if you’re: Upgrading to Docsy 0.16.0 Upgrading only Hugo Review BREAKING …

    Read more

  • Release 0.15.0 report and upgrade guide

    Friday, May 01, 2026 in Blog

    Highlights Agent support: llms.txt, Markdown page output, and a “View Markdown” page-meta link Doc-rooted sites: improved support for publishing docs at the site root Version menus: richer entries and updated navbar rendering Release …

    Read more

  • Release 0.14.0 report and upgrade guide

    Tuesday, February 10, 2026 in Blog

    Patch updates 0.14.1 to 0.14.3 For the key fixes of these patch updates, see 0.14.1, 0.14.2, and 0.14.3. For other changes to 0.14.2, see Patch update 0.14.2. If you are upgrading now, follow this guide and use 0.14.3 where it references 0.14.0. …

    Read more

  • Hugo 0.152.0-0.155.x upgrade guide

    Monday, February 09, 2026 in Blog

    This post summarizes the breaking and notable changes in Hugo 0.152.0 to 0.155.3. It is a companion post to the Docsy 0.14.0 and 0.13.0 release and upgrade guides. Upgrade summary This guide highlights breaking changes in Hugo 0.152.0–0.155.x and the …

    Read more

Posts in 2025
  • Release 0.13.0 report and upgrade guide

    Monday, November 24, 2025 in Blog

    Highlights Docsy 0.13.0 includes the most upvoted enhancement request of 2025, and more. This release has new features and only minor breaking changes.1 Read about our experiences using AI to upgrade Docsy projects. Release summary Docsy 0.13.0 …

    Read more

  • Upgrade to Docsy 0.12.0 from 0.11.0

    Tuesday, November 11, 2025 in Blog

    Since we didn’t publish a release announcement for 0.12.0, I’m using this opportunity to walk through the upgrade process from 0.11.0 to 0.12.0. TL;DR: The main breaking changes in Docsy 0.12.0 stem from Hugo’s new template system, …

    Read more

Posts in 2024
  • Docsy 2024 Review: Adoptions and Enhancements

    Thursday, December 12, 2024 in Blog

    As we reflect on 2024, it’s exciting to see steady progress toward the goals outlined in our 2024 priorities. This year, we focused on enhancing stability, improving internationalization, and delivering long-anticipated features like dark mode and …

    Read more