I believe you should use `@param` and `@return` for Epydoc.. check pyspark/conf.py for example. Or have you tried generating the docs with this and seen it work?