{"action":"created","issue":{"url":"https://api.github.com/repos/lipp/doclets/issues/82","repository_url":"https://api.github.com/repos/lipp/doclets","labels_url":"https://api.github.com/repos/lipp/doclets/issues/82/labels{/name}","comments_url":"https://api.github.com/repos/lipp/doclets/issues/82/comments","events_url":"https://api.github.com/repos/lipp/doclets/issues/82/events","html_url":"https://github.com/lipp/doclets/issues/82","id":144665200,"number":82,"title":"Support for nested options","user":{"login":"janmeier","id":1210224,"avatar_url":"https://avatars.githubusercontent.com/u/1210224?v=3","gravatar_id":"","url":"https://api.github.com/users/janmeier","html_url":"https://github.com/janmeier","followers_url":"https://api.github.com/users/janmeier/followers","following_url":"https://api.github.com/users/janmeier/following{/other_user}","gists_url":"https://api.github.com/users/janmeier/gists{/gist_id}","starred_url":"https://api.github.com/users/janmeier/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/janmeier/subscriptions","organizations_url":"https://api.github.com/users/janmeier/orgs","repos_url":"https://api.github.com/users/janmeier/repos","events_url":"https://api.github.com/users/janmeier/events{/privacy}","received_events_url":"https://api.github.com/users/janmeier/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2016-03-30T17:46:41Z","updated_at":"2016-03-31T05:55:16Z","closed_at":null,"body":"Currently nested and top-level parameters are rendered in a single list - which can become very long, see below \r\n\r\n![image](https://cloud.githubusercontent.com/assets/1210224/14151561/d6375c9a-f6ae-11e5-82fa-48bc7a804819.png)\r\nWhich is generated from https://github.com/sequelize/sequelize/blob/35e68f67b9be2702109157b6d066781555d43202/lib/model.js#L1314-L1344\r\n\r\nRegular jsdoc shows this as a nested table, but keeping with the doclets list structure we could go for nested lists instead - note that I also removed the `options.` prefix in order to take up less space\r\n\r\n![image](https://cloud.githubusercontent.com/assets/1210224/14151769/e2d9178a-f6af-11e5-8ee3-da7c13bccbd4.png)\r\n\r\nIt's still hella-long, but at least it's a bit easier to see what goes where - I also made the margins on the nested lists a bit smaller :)"},"comment":{"url":"https://api.github.com/repos/lipp/doclets/issues/comments/203766060","html_url":"https://github.com/lipp/doclets/issues/82#issuecomment-203766060","issue_url":"https://api.github.com/repos/lipp/doclets/issues/82","id":203766060,"user":{"login":"lipp","id":445883,"avatar_url":"https://avatars.githubusercontent.com/u/445883?v=3","gravatar_id":"","url":"https://api.github.com/users/lipp","html_url":"https://github.com/lipp","followers_url":"https://api.github.com/users/lipp/followers","following_url":"https://api.github.com/users/lipp/following{/other_user}","gists_url":"https://api.github.com/users/lipp/gists{/gist_id}","starred_url":"https://api.github.com/users/lipp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lipp/subscriptions","organizations_url":"https://api.github.com/users/lipp/orgs","repos_url":"https://api.github.com/users/lipp/repos","events_url":"https://api.github.com/users/lipp/events{/privacy}","received_events_url":"https://api.github.com/users/lipp/received_events","type":"User","site_admin":false},"created_at":"2016-03-31T05:55:16Z","updated_at":"2016-03-31T05:55:16Z","body":":+1:  i like that! i think it's  good compromise between readability an space consumption. maybe the fullname (options.include.model) could be added as tooltip (on hover)."}}