miniblog.

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?

A common UI antipattern is to make the structure directly reflect the implementation. If you have 4 database tables, you build 4 screens. This may not reflect how users want to get things done. Does this happen outside of software? I suspect it does, but I can't find examples.