Really great documentation would be nice. I know that it has been improving, but maybe GSOC is an excuse for a sprint? Ideally, the documenter is someone who really knows DSP and what is going on behind the curtains.
References to examples in the documentation would help out immensely. I often resort to hunting down a block's source code or other blocks and examples that use the block to understand it.
I have always wanted an auto-magically generated list of references to other blocks/examples that use the block being documented. I think this would be easy to do in python. When building the docs, a script could search for instances of each block in other blocks and examples, then insert them as references in the block's documentation.
As someone with little DSP backrground, I would like to be able to see some great documentation when I open up a block in GRC or introspect it in python.