Sundy doc changes

All documentation changes, mostly removing the abuse of {} for multiple return types.
nitpick, should be ``int`` not ``integer``