Sundy doc changes

All documentation changes, mostly removing the abuse of {} for multiple return types.
Parenthesis should be removed for ```optional``` to match the other docstrings