I meant instead of pulling out a block of code and interpolating it later. For example instead of: <set up> <do stuff> <tear down> And then descri

I meant instead of pulling out a block of code and interpolating it later. For example instead of: <set up> <do stuff> <tear down> And then describing them in the rest of the document, a better solution to me seems to be able to click on e.g. the <do stuff> part to expand it. This allows the reader to see the high level structure and drill down to the stuff he's interested in instead of spreading the code all over the place with references.