how do you collaborate on a markdown doc with non-devs without losing your source of truth?

most of my docs are markdown now, a lot of it out of agents I've got running. writing's solved. collaborating on review is the broken part.

the reviewers aren't technical. a PM, ops, a client. and yeah, github PR comments is the dev answer, they won't touch it. so the second I share it somewhere they'll actually open, it splinters, one gets a pdf, one a google docs paste, one replies over slack, and I'm merging notes back into a .md that already moved on.

what I wanted was everyone on the same rendered page, commenting on the line they care about, all pinned to the one markdown file that stays canonical. couldn't find it so I built something.

happy to share if anyone's interested. mostly want to know if this is a real problem or just me.

reddit.com
u/jonathan_b2 — 7 days ago

how do you collaborate on a markdown doc with non-devs without losing your source of truth?

most of my docs are markdown now, a lot of it out of agents I've got running. writing's solved. collaborating on review is the broken part.

the reviewers aren't technical. a PM, ops, a client. and yeah, github PR comments is the dev answer, they won't touch it. so the second I share it somewhere they'll actually open, it splinters, one gets a pdf, one a google docs paste, one replies over slack, and I'm merging notes back into a .md that already moved on.

what I wanted was everyone on the same rendered page, commenting on the line they care about, all pinned to the one markdown file that stays canonical. couldn't find it so I built something.

happy to share if anyone's interested. mostly want to know if this is a real problem or just me.

reddit.com
u/jonathan_b2 — 7 days ago