Improved make doc

* Parameterized the output directory
* Use option -u by default to only rescan the updated files
* .PHONY target for docs
Some documentation love

Better doc comments for BaseCollection, IndexMixin, IndexCollection
and Resource.
Doc formatting improvements
Merge pull request #11 from mzabaluev/document

Improvements to documentation