setters/getters: create some basic documentation

[igaw]

Eventually we should also add some documentation to when generating the headers. Modern IDEs are showing this during typing, which is really helpful.