Docs improvements

Some docs improvements solving some issues.
maybe add a comment mentioning getters and setters