Examples Are the Best Documentation(rakhim.exotext.com)

372 points by Bogdanp 1 year ago | 137 comments

Blog post by Rakhim arguing that concrete examples are the most useful form of technical documentation and are often missing from official docs.

TODOs aren't for doing(sophiebits.com)

380 points by todsacerdoti 1 year ago | 218 comments

A blog post by Sophie Alpert arguing that TODO comments are valuable as documentation of known issues even if never acted on, and shouldn't be auto-deleted or tracked.

Trolltech's Documentation Process(rant.gulbrandsen.priv.no)

43 points by whatever3 2 years ago | 14 comments

On finishing projects(alexreichert.com)

195 points by reichertjalex 2 years ago | 76 comments

MdBook – a command line tool to create books with Markdown(rust-lang.github.io)

168 points by peter_d_sherman 1 year ago | 57 comments

Show HN: Huzzah – a novel approach to coding with AI(danielvaughn.dev)

334 points by danielvaughn 2 months ago | 178 comments

Blog post introducing Huzzah, an experimental editor where you write pseudocode that is synced to real source code by AI on save, with the pseudocode kept as intent.