All articles

Tag

Confluence

4 articles

ADR Publishing Pipeline: From Architecture Decision to Confluence in 60 Seconds

ADRs die in the repo because only engineers read git. Here's how to wire a pipeline that publishes every merged ADR to Confluence (and Notion) automatically — with a worked .mdspecmap example.

7 min read

Publish Markdown to Confluence with GitHub Actions in One Line: A 2026 Setup Guide

A plain comparison of every real option for syncing markdown from GitHub to Confluence — mark, markdown-confluence, duo-labs, and mdspec — with a complete working setup you can copy today.

11 min read

mdspec in 5 Minutes: From Zero to Publishing Markdown on Every Merge

A screencast-style walkthrough: create a repo, add one .mdspecmap, add the GitHub Actions step, push a commit, see it appear in Confluence or Notion. Real YAML throughout.

6 min read

Spec Drift: Why Your Markdown Files and Your Notion/Confluence Pages Stop Matching (And What to Do About It)

Spec drift isn't a discipline problem — it's an architectural one. Here's how to name it, audit for it, and fix it structurally so it stops coming back.

9 min read