~/.mathieu

  • About
  • Projects
  • Garden
Home

❯

slips

❯

Self documenting systems

Self documenting systems

28 Jan 2025

  • thought
  • knowledge
  • technical
  • methodology

When you have a system like NixOS, Nix flakes or infrastructure as code, the code or configuration is verbose and descriptive. It could be seen as basic documentation

Sometimes, documentation can even ensure implementation: api documentation can run implementation tests.


Backlinks

  • Import your highlights with ease
  • Basic documentation is a must for system administration
  • Make yourself replaceable in order to sell your business
  • Software engineering
  • Ideas to create boring software

Recent Notes

  • Metrics only capture things that can be quantified

    11 Mar 2026

    • thought
    • measure
    • data-quality
  • Don't be data-driven; be data-informed

    11 Mar 2026

    • blueprint
    • measure
    • decisions
    • risk
  • Cutting metrics is sometimes beneficial

    11 Mar 2026

    • thought
    • way-of-work
    • prioritisation
  • Home
  • Recent notes
  • Timeline
  • RSS Feed

Created with Quartz v4.5.0 © 2026