[corbins]

The counterexample here is the declarative style of programming. Most ideally this looks like an executable spec and is documentation itself.

[ativzzz]

Sure, but then you offload the complexity to the functions used as the declarative building blocks, so you do the documenting in a different place, though you will probably end up documenting complex declarative business logic anyway. (like why is process X that is so similar to process Y require Z different declarative blocks)

[lmilcin]

Only for simple cases. When it becames complex enough the same problems show.

Example: CSS.