miniblog.

LLVM's lit tool for testing files is the most successful testing DSL I've ever seen. It's used a decent number of projects outside of LLVM. By contrast I don't see many folks using e.g. Cucumber these days.

I've been playing with labels on my code blocks. Sometimes I have useful labels, other times it's just "Example 2". It's also unclear exactly where I put the label: Inside the box? Outside? Are there any docs sites that do this really well?

Anecdotally, I've noticed more frequent doc comments in languages that put them inside the function (e.g. Python, Lisp) rather than outside (JS, Rust). Perhaps it's easier to write the rough signature before the explanation?