Documentation update & TODO for stuff promised in doc
Some more documentation sugar