Technical Writing
  • Home
  • Topics
  • Docs
  • About
  • Contact
  • Search
  • Ask the assistant
  • Home
  • Topics
  • Documentation Manual
  • About
  • Contact
  • Search
  • Ask the assistant

Tag

Git

4 articles

  • A row of blue pneumatic hoses fitted into stainless steel connectors on a factory line

    You Probably Don’t Need a CMS: Building a Lightweight Admin with Git and Astro

    Most of a small organization’s website barely changes. This is an argument for building the smallest editing interface it actually needs, using Astro, Git, YAML, and a small admin layer instead of a full CMS.

    Sep 8, 2026
  • Close-up of an industrial printing press, its metal rollers and inked mechanics in sharp focus

    Why hand-maintained InDesign files rot — and what docs-as-code does instead

    A 370-cell calendar that shifts every year. A lead’s name in three places. An IBAN in an invisible text box. These are not unusual InDesign problems — they are what InDesign files become when they accumulate facts with no single home. Two projects show what the alternative looks like — and where InDesign’s own global tools stop short.

    Jun 23, 2026
  • An open filing cabinet drawer

    Manage content in files, not databases

    Databases are not always the best place for your content. By storing it in plain files, you gain speed, security, Git-based workflows, and a simpler, more reliable publishing stack.

    Sep 18, 2025
  • Stepping stones crossing a river

    A web journey: from HTML to Git-based Markdown workflows

    Tracing over two decades of web publishing, from raw HTML and Dreamweaver to CMSes, structured content, static site generators, and modern Git-based Markdown workflows. Lessons for solo and team content developers on maintainability, collaboration, and performance.

    Jul 10, 2025
← Back to Blog
Documentation Manual Connect on LinkedIn Subscribe via RSS