DOC: New documentation system based on numpydoc

The system is stolen from pandas and the current docs are changed
so that they fit into the new doc system.
DOC: Update gitignore with documentation changes
DOC: Make existing docstrings numpydoc compatible