{"action":"created","issue":{"url":"https://api.github.com/repos/dart-lang/dartdoc/issues/842","labels_url":"https://api.github.com/repos/dart-lang/dartdoc/issues/842/labels{/name}","comments_url":"https://api.github.com/repos/dart-lang/dartdoc/issues/842/comments","events_url":"https://api.github.com/repos/dart-lang/dartdoc/issues/842/events","html_url":"https://github.com/dart-lang/dartdoc/issues/842","id":102266660,"number":842,"title":"Constants list is scary","user":{"login":"kwalrath","id":2164483,"avatar_url":"https://avatars.githubusercontent.com/u/2164483?v=3","gravatar_id":"","url":"https://api.github.com/users/kwalrath","html_url":"https://github.com/kwalrath","followers_url":"https://api.github.com/users/kwalrath/followers","following_url":"https://api.github.com/users/kwalrath/following{/other_user}","gists_url":"https://api.github.com/users/kwalrath/gists{/gist_id}","starred_url":"https://api.github.com/users/kwalrath/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kwalrath/subscriptions","organizations_url":"https://api.github.com/users/kwalrath/orgs","repos_url":"https://api.github.com/users/kwalrath/repos","events_url":"https://api.github.com/users/kwalrath/events{/privacy}","received_events_url":"https://api.github.com/users/kwalrath/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-08-21T00:18:18Z","updated_at":"2015-08-21T17:20:03Z","closed_at":null,"body":"Looking at https://new-dartdocs-dot-dartlang-api.appspot.com/1.12.0-dev.5.8/dart-html/Element-class.html, the list of constants is really hard to read and makes me hesitate to look at anything else on the page. (Being able to collapse the whole section would be nice, but I'll file a separate bug about that.)\r\n\r\nHere's what the new Element page looks like:\r\n\r\n![image](https://cloud.githubusercontent.com/assets/2164483/9398576/6e4e5bc0-475d-11e5-8b9a-ae5a0ace336b.png)\r\n\r\nIt also seems like overkill to have to go to another page to see the complete doc for a constant.\r\n\r\nThe previous treatment of constants is more readable (although I much prefer the name \"Constants\" to \"Static Properties\"!):\r\n\r\n![image](https://cloud.githubusercontent.com/assets/2164483/9398620/bf40a0ec-475d-11e5-9f47-1dd0cdd2cbd7.png)\r\n\r\nI'm fine with Constants being first, but (especially if they're going to be documented on separate pages) I'd really like to see a simpler, less implementation-heavy list of constants. Something like this, maybe:\r\n\r\n## Constants\r\n<table>\r\n<tr>\r\n  <td><b>abortEvent</b><br>EventStreamProvider&lt;Event></td>\r\n  <td>Static factory designed to expose abort events to event handlers that are not necessarily...</td>\r\n</tr>\r\n<tr>\r\n  <td><b>beforeCopyEvent</b><br>EventStreamProvider&lt;Event></td>\r\n  <td> Static factory designed to expose beforecopy events to event handlers that are not necessarily...</td>\r\n</tr>\r\n</table>\r\n\r\nOr this:\r\n\r\n## Constants\r\n<table>\r\n<tr>\r\n  <td>EventStreamProvider&lt;Event></td>\r\n  <td><b>abortEvent</b> <br>\r\n      Static factory designed to expose abort events to event handlers that are not necessarily...</td>\r\n</tr>\r\n<tr>\r\n  <td>EventStreamProvider&lt;Event></td>\r\n  <td><b>beforeCopyEvent</b><br>\r\n      Static factory designed to expose beforecopy events to event handlers that are not necessarily...</td>\r\n</tr>\r\n</table>\r\n\r\nOr even this:\r\n\r\n## Constants\r\n<table>\r\n<tr>\r\n  <td>EventStreamProvider&lt;Event><br>\r\n         <b>abortEvent</b>\r\n  </td>\r\n  <td>Static factory designed to expose abort events to event handlers that are not necessarily...</td>\r\n</tr>\r\n<tr>\r\n  <td>EventStreamProvider&lt;Event><br>\r\n        <b>beforeCopyEvent</b></td>\r\n  <td> Static factory designed to expose beforecopy events to event handlers that are not necessarily...</td>\r\n</tr>\r\n</table>\r\n"},"comment":{"url":"https://api.github.com/repos/dart-lang/dartdoc/issues/comments/133501217","html_url":"https://github.com/dart-lang/dartdoc/issues/842#issuecomment-133501217","issue_url":"https://api.github.com/repos/dart-lang/dartdoc/issues/842","id":133501217,"user":{"login":"alan-knight","id":3476088,"avatar_url":"https://avatars.githubusercontent.com/u/3476088?v=3","gravatar_id":"","url":"https://api.github.com/users/alan-knight","html_url":"https://github.com/alan-knight","followers_url":"https://api.github.com/users/alan-knight/followers","following_url":"https://api.github.com/users/alan-knight/following{/other_user}","gists_url":"https://api.github.com/users/alan-knight/gists{/gist_id}","starred_url":"https://api.github.com/users/alan-knight/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/alan-knight/subscriptions","organizations_url":"https://api.github.com/users/alan-knight/orgs","repos_url":"https://api.github.com/users/alan-knight/repos","events_url":"https://api.github.com/users/alan-knight/events{/privacy}","received_events_url":"https://api.github.com/users/alan-knight/received_events","type":"User","site_admin":false},"created_at":"2015-08-21T17:20:03Z","updated_at":"2015-08-21T17:20:03Z","body":"It is scary. It's also noticeable that it has the type declaration in front, so constants are different from non-const properties for no obvious reason."}}