it's somewhat mixed in the core code... For long blocks, I prefer to do it in the docs to make it more readable.