doc generation is working with 'make html' and automatically fetching api details (by adding sys.path.insert in conf.py). now need to document our real api