{"action":"created","issue":{"url":"https://api.github.com/repos/esdoc/esdoc/issues/108","repository_url":"https://api.github.com/repos/esdoc/esdoc","labels_url":"https://api.github.com/repos/esdoc/esdoc/issues/108/labels{/name}","comments_url":"https://api.github.com/repos/esdoc/esdoc/issues/108/comments","events_url":"https://api.github.com/repos/esdoc/esdoc/issues/108/events","html_url":"https://github.com/esdoc/esdoc/issues/108","id":110333888,"number":108,"title":"documentation getter/setters","user":{"login":"christophehurpeau","id":302891,"avatar_url":"https://avatars.githubusercontent.com/u/302891?v=3","gravatar_id":"","url":"https://api.github.com/users/christophehurpeau","html_url":"https://github.com/christophehurpeau","followers_url":"https://api.github.com/users/christophehurpeau/followers","following_url":"https://api.github.com/users/christophehurpeau/following{/other_user}","gists_url":"https://api.github.com/users/christophehurpeau/gists{/gist_id}","starred_url":"https://api.github.com/users/christophehurpeau/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/christophehurpeau/subscriptions","organizations_url":"https://api.github.com/users/christophehurpeau/orgs","repos_url":"https://api.github.com/users/christophehurpeau/repos","events_url":"https://api.github.com/users/christophehurpeau/events{/privacy}","received_events_url":"https://api.github.com/users/christophehurpeau/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/esdoc/esdoc/labels/Result:%20WontFix","name":"Result: WontFix","color":"207de5"},{"url":"https://api.github.com/repos/esdoc/esdoc/labels/Scope:%20Publisher","name":"Scope: Publisher","color":"eb6420"},{"url":"https://api.github.com/repos/esdoc/esdoc/labels/Type:%20Feature","name":"Type: Feature","color":"009800"}],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":9,"created_at":"2015-10-07T22:49:20Z","updated_at":"2016-04-05T08:25:31Z","closed_at":"2015-10-10T10:31:12Z","body":"getters and setters should be documented like a property\r\n\r\nIf there is only a getter, a information \"readonly\" could be displayed\r\n\r\nWhat do you think ?\r\n\r\nHere how to document getters/setters in jsdoc: https://github.com/jsdoc3/jsdoc/issues/973"},"comment":{"url":"https://api.github.com/repos/esdoc/esdoc/issues/comments/205717296","html_url":"https://github.com/esdoc/esdoc/issues/108#issuecomment-205717296","issue_url":"https://api.github.com/repos/esdoc/esdoc/issues/108","id":205717296,"user":{"login":"timdp","id":201034,"avatar_url":"https://avatars.githubusercontent.com/u/201034?v=3","gravatar_id":"","url":"https://api.github.com/users/timdp","html_url":"https://github.com/timdp","followers_url":"https://api.github.com/users/timdp/followers","following_url":"https://api.github.com/users/timdp/following{/other_user}","gists_url":"https://api.github.com/users/timdp/gists{/gist_id}","starred_url":"https://api.github.com/users/timdp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/timdp/subscriptions","organizations_url":"https://api.github.com/users/timdp/orgs","repos_url":"https://api.github.com/users/timdp/repos","events_url":"https://api.github.com/users/timdp/events{/privacy}","received_events_url":"https://api.github.com/users/timdp/received_events","type":"User","site_admin":false},"created_at":"2016-04-05T08:25:30Z","updated_at":"2016-04-05T08:25:30Z","body":"@h13i32maru Sorry to unearth this thread, but I think you're misinterpreting the comments here. Yes, from a strictly semantical perspective, `inst.foo` and `inst.bar` are different in your example, but API docs get generated for the person *using* the API, and that person shouldn't be aware of the implementation. If the author of the API decides to change the implementation of `foo` or `bar` to either getter/setter or a regular object property, it won't affect the behavior at all. What matters is that it's a property that one can get and set from outside the class.\r\n\r\nI originally came here looking for a way not to write redundant comments such as:\r\n\r\n```\r\nclass A {\r\n  /**\r\n   * Description of b.\r\n   *\r\n   * @type {string}\r\n   */\r\n  get b () { return this._b }\r\n\r\n  /**\r\n   * Description of b.\r\n   *\r\n   * @type {string}\r\n   */\r\n  set b (value) { this._b = value }\r\n}\r\n```\r\n\r\nEven if there's a different syntax or option which allows that, just being able to write `@property {string} Description of b.` would make *so* much more sense."}}