Improved doc:
- added metadata and join arrays section in the tutorial
- reorganized doc into Intro, Tutorial, Advanced, Reference API
- added missing data and metadata sections to Reference API doc
- cleaned up the Reference section
- cleaned up docstrings
- html from pandas output are now rendered (nbconvert_to_rst.py)