Why I Prefer RST to Markdown

Re:Why I Prefer RST to Markdown by runlevel1 on Wednesday July 31, 2024 @09:19PM (#41125300)

Ironically, that was my argument for getting rid of Confluence. Confluence should be the low barrier to entry solution, but its buggy, clunky GUI ends up actively punishing anyone who dares try to update docs. So a repo full of markdown files with a self-merge pipeline ends up being lower-resistance.

[ Parent | on HN ]

Re:Why I Prefer RST to Markdown by AndIHateLatex on Wednesday July 31, 2024 @09:41PM (#41125432)

I wonder if Spotify was right on the money with their Techdocs approach. It's all just Markdown files being rendered in another format, and the edit button is just sends you to a github or equivalent editing page. People want the idea of a platform... but do they need one?

[ Parent | on HN ]

Re:Why I Prefer RST to Markdown by eru on Wednesday July 31, 2024 @11:54PM (#41126005)

Well, you could get similar results by just spinning up a copy of the Wikipedia software. Their formatting language even looks enough like markdown in practice (despite appearing earlier).

[ Parent | on HN ]