The Diátaxis framework that fixes most broken documentation — separating tutorials, how-to guides, reference, and explanation — and why mixing those four modes on one page is why users skim, give up, and file issues the docs already answer.
Developer-Experience
-
Diátaxis for Technical Writing: The Framework Behind Great Docs -
Score: Developer-Centric Workload Specification Score lets developers write a single score.yaml that deploys to Docker Compose locally and Kubernetes in production — without rewriting config for each environment.
-
Dagger: Portable CI/CD Pipelines That Run Everywhere Write CI/CD pipelines in Go, Python, or TypeScript that run identically on your laptop and in CI — no more YAML hell, no more 'works locally but fails in GitHub Actions'. A complete Dagger guide.
-
Internal Developer Platforms with Backstage: Building the Golden Path How to build an Internal Developer Platform with Spotify's Backstage: setting up the software catalog, scaffolding golden-path templates, publishing TechDocs, and wiring up plugins for a self-service developer experience.
-
Mise: The Universal Version Manager That Replaces Everything How mise replaces nvm, pyenv, rbenv, sdkman, and tfenv with a single tool — managing runtimes, environment variables, and tasks across every project with a unified .mise.toml config.
-
Taskfile: A Better Makefile for Modern Development Why Taskfile is replacing Makefiles for developer experience: defining tasks with dependencies, variable interpolation, cross-platform support, and seamless CI integration.
-
Developer Portals with Backstage: Catalog, Scaffolding, TechDocs, and Plugins A practical guide to Backstage — setting up the software catalog, creating service templates for self-service scaffolding, writing TechDocs, building plugins, and deploying Backstage to Kubernetes.
-
Internal Developer Platforms: Building the Golden Path A practical guide to designing and building an Internal Developer Platform — self-service infrastructure, service templates, environment management, and the abstractions that let product teams ship without becoming Kubernetes experts.
-
Nix and NixOS for Developers: Reproducible Environments, Flakes, and devShells A practical guide to Nix — the purely functional package manager that makes development environments reproducible, declarative, and composable. Covers nix-shell, flakes, devShells, home-manager, and NixOS for those ready to go all in.
-
Platform Engineering vs DevOps: What Changed and Why It Matters A clear-eyed look at what Platform Engineering actually is, how it differs from DevOps, why the shift happened, and how to build a platform team that developers actually want to use.
-
OpenAPI and Swagger: Designing and Documenting APIs Contract-First Learn how to design and document APIs contract-first using the OpenAPI Specification — covering document structure, schemas, security, code generation, and the full tooling ecosystem from Swagger UI to Prism mock servers.
-
Writing Good READMEs: Documentation That Developers Actually Read A practical guide to writing READMEs that developers actually read — covering structure, examples, anti-patterns, and templates for open-source and internal projects alike.