Attempts to improve docstring rendering for two modules

This commit fixes some of the rendering issues with the documentation
in forms_facets.py and function_space.py. See issue #42.