Dewan Ahmed personal blog

Markdown, Asciidoc, or reStructuredText – a tale of docs-as-code

dewanahmed.com published 2023-01-0922 min read

Who writes the developer documentation for your product? During the early days of my tech career, I worked on a database replication product at IBM. My immediate team had developers and testers but not a single technical writer. I can speak for myself when I say that I never bothered to know who keeps writing the…

Points

178

HN comments

88

Submissions

1

Cited by

0 commenters

Tools & ProductivitySoftware Engineering2022

Related posts from the same era

An Unbelievable Demo

BBrendan Gregg20212,339 points482 commentscited by 5 details

macOS command-line tools you might not know about

Ssaurabhs.org20232,039 points442 comments details

Show HN: Redbean – Single-file distributable web server

JJustine Tunney20211,998 points261 commentscited by 7 details

Everything that uses configuration files should report where they're located

Chris Siebenmann20231,744 points472 comments details

Use forums rather than Slack/Discord to support developer community

Dan Moore20211,631 points671 comments details

Contra Wirecutter on the IKEA air purifier

Dynomight20221,474 points925 commentscited by 11 details