Add a way to include snippets from files into Haddock comments
An approach I've used in the past to get checked/tested code snippets in documentation is to put the examples in a separate file and then include them into the documentation. For example, you can use RsT's literalinclude
directive for this.
The advantage of this is that it makes it very simple to check/test the examples: you just have a normal file that you can build as usual with your build tool, rather than having to cleverly pull stuff out of your documentation.
It would be nice if Haddock had the facility to do something like this!