{"action":"opened","issue":{"url":"https://api.github.com/repos/angular/angular/issues/10939","repository_url":"https://api.github.com/repos/angular/angular","labels_url":"https://api.github.com/repos/angular/angular/issues/10939/labels{/name}","comments_url":"https://api.github.com/repos/angular/angular/issues/10939/comments","events_url":"https://api.github.com/repos/angular/angular/issues/10939/events","html_url":"https://github.com/angular/angular/issues/10939","id":172098766,"number":10939,"title":"Reference documentation doesn't list extended classes and implemented interfaces","user":{"login":"jnizet","id":1608223,"avatar_url":"https://avatars.githubusercontent.com/u/1608223?v=3","gravatar_id":"","url":"https://api.github.com/users/jnizet","html_url":"https://github.com/jnizet","followers_url":"https://api.github.com/users/jnizet/followers","following_url":"https://api.github.com/users/jnizet/following{/other_user}","gists_url":"https://api.github.com/users/jnizet/gists{/gist_id}","starred_url":"https://api.github.com/users/jnizet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jnizet/subscriptions","organizations_url":"https://api.github.com/users/jnizet/orgs","repos_url":"https://api.github.com/users/jnizet/repos","events_url":"https://api.github.com/users/jnizet/events{/privacy}","received_events_url":"https://api.github.com/users/jnizet/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2016-08-19T10:10:57Z","updated_at":"2016-08-19T10:10:57Z","closed_at":null,"body":"**I'm submitting a ...**  (check one with \"x\")\r\n```\r\n[x] bug report => search github for a similar issue or PR before submitting\r\n[ ] feature request\r\n[ ] support request => Please do not submit support request here, instead see https://github.com/angular/angular/blob/master/CONTRIBUTING.md#question\r\n```\r\n\r\nFirst, I'm sorry if I'm submitting this to the wrong project. This bug is about the reference documentation, and I don't know if I should submit it here or in angular.io or somewhere else. Please forgive me if it's the wrong place.\r\n\r\n**Current behavior**\r\n\r\nThe reference documentation doesn't mention the superclass and implemented interfaces of the classes, making it impossible to find the attributes and methods actually available on a type, and to understand the examples listed in the reference doc or in the tutorials, without reading the source code.\r\n\r\nFor example, the documentation for NgForm has an example showing how to use its `value` attribute to submit the form, but there is no `value` attribute in NgForm. The only way I could find this information was by reading the source code and discovering that value was a field of the inherited `AsbtractControlDirective` class. \r\n\r\n**Expected/desired behavior**\r\n\r\nThe reference documentation should, at minimum, display the superclass and implemented interfaces of all classes.\r\n\r\nA link would be even better (and same for the types of the attributes, arguments and return types, by the way, which could link to the documentation of their type)\r\n\r\nEven better would be to have a list of inherited members, linking directly to their documentation in the superclass documentation.\r\n\r\nIn short, I expect the same level of usability as the javadoc, for example.\r\n\r\n**Reproduction of the problem**\r\nGo to https://angular.io/docs/ts/latest/api/forms/index/NgForm-directive.html, and try to find if NgForm really has a `value` or a `valid` attribute.\r\n\r\n\r\n**What is the expected behavior?**\r\nI should be able to find this information without having to read the source code.\r\n\r\n\r\n**What is the motivation / use case for changing the behavior?**\r\nUnderstand the examples. Being able to discover attributes and methods without reading the source code\r\n\r\n\r\n**Please tell us about your environment:**\r\n\r\n* **Angular version:** 2.0.0-rc.5\r\n \r\n* **Browser:** all \r\n \r\n* **Language:** TypeScript"}}
{"actor":{"display_login":"jnizet"}}