{"action":"created","issue":{"url":"https://api.github.com/repos/Aratramba/jade-doc/issues/35","labels_url":"https://api.github.com/repos/Aratramba/jade-doc/issues/35/labels{/name}","comments_url":"https://api.github.com/repos/Aratramba/jade-doc/issues/35/comments","events_url":"https://api.github.com/repos/Aratramba/jade-doc/issues/35/events","html_url":"https://github.com/Aratramba/jade-doc/issues/35","id":115486210,"number":35,"title":"Argument documentation causes unexpected behaviour","user":{"login":"jantimon","id":4113649,"avatar_url":"https://avatars.githubusercontent.com/u/4113649?v=3","gravatar_id":"","url":"https://api.github.com/users/jantimon","html_url":"https://github.com/jantimon","followers_url":"https://api.github.com/users/jantimon/followers","following_url":"https://api.github.com/users/jantimon/following{/other_user}","gists_url":"https://api.github.com/users/jantimon/gists{/gist_id}","starred_url":"https://api.github.com/users/jantimon/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jantimon/subscriptions","organizations_url":"https://api.github.com/users/jantimon/orgs","repos_url":"https://api.github.com/users/jantimon/repos","events_url":"https://api.github.com/users/jantimon/events{/privacy}","received_events_url":"https://api.github.com/users/jantimon/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-11-06T11:17:45Z","updated_at":"2015-11-09T07:51:59Z","closed_at":null,"body":"```\r\n//- @jadedoc\r\n  name: mixin\r\n  description: this is jade mixin documentation\r\n  arguments: \r\n    size: {number} - the size in inches\r\n    beFunky: {boolean} - wether this mixin should be funky\r\n\r\nmixin mixin2(size, beFunky)\r\n  div #{size * 3}\r\n  div the mixin is #{beFunky ? 'funky' : 'not funky'}\r\n```\r\n\r\nUnfortunately this is compiled and executed:\r\nhttps://github.com/Aratramba/jade-doc/blob/master/index.js#L188\r\n\r\nHow would I document the argument types and description rather one example value?"},"comment":{"url":"https://api.github.com/repos/Aratramba/jade-doc/issues/comments/154989983","html_url":"https://github.com/Aratramba/jade-doc/issues/35#issuecomment-154989983","issue_url":"https://api.github.com/repos/Aratramba/jade-doc/issues/35","id":154989983,"user":{"login":"Aratramba","id":580312,"avatar_url":"https://avatars.githubusercontent.com/u/580312?v=3","gravatar_id":"","url":"https://api.github.com/users/Aratramba","html_url":"https://github.com/Aratramba","followers_url":"https://api.github.com/users/Aratramba/followers","following_url":"https://api.github.com/users/Aratramba/following{/other_user}","gists_url":"https://api.github.com/users/Aratramba/gists{/gist_id}","starred_url":"https://api.github.com/users/Aratramba/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Aratramba/subscriptions","organizations_url":"https://api.github.com/users/Aratramba/orgs","repos_url":"https://api.github.com/users/Aratramba/repos","events_url":"https://api.github.com/users/Aratramba/events{/privacy}","received_events_url":"https://api.github.com/users/Aratramba/received_events","type":"User","site_admin":false},"created_at":"2015-11-09T07:51:59Z","updated_at":"2015-11-09T07:51:59Z","body":"I think your example makes perfect sense. There is no way achieve this yet, but I agree, for code documentation purposes it is essential to be able to  specify argument type. So it would be nice to extend current functionality. Something like this:\r\n\r\n```yaml\r\narg: example value\r\narg: {type} example value\r\narg: {type} - example value\r\n```\r\n\r\nAnd for objects / arrays\r\n\r\n```jade\r\n//- @jadedoc\r\n  arg: {object} { name: 'foo' }\r\n\r\nmixin foo(arg)\r\n  | #{arg.name}\r\n\r\n// +foo({ name: 'foo' })\r\n```\r\n\r\n```jade\r\n//- @jadedoc\r\n  arg: {array} ['one', 'two', 'three']\r\n\r\nmixin foo(arg)\r\n  | #{arg[0]}\r\n\r\n// +foo(['one', 'two', 'three'])\r\n```\r\n\r\nagree?"}}