http://qs321.pair.com?node_id=11117810


in reply to Re^2: Section Dividers - What are your thoughts (POD antipattern)
in thread Section Dividers - What are your thoughts

The documentation will show up in the same order like programmed and must stay at this chronological position.
This might make a case for literal programming (write code and documentation in the order one would want to read it, but reorder the code chunks in the order it should run in), but that comes with its own bag of problems and requires trade-offs that one might consider unacceptable.