{"action":"created","issue":{"url":"https://api.github.com/repos/OpenWaterAnalytics/EPANET/issues/24","labels_url":"https://api.github.com/repos/OpenWaterAnalytics/EPANET/issues/24/labels{/name}","comments_url":"https://api.github.com/repos/OpenWaterAnalytics/EPANET/issues/24/comments","events_url":"https://api.github.com/repos/OpenWaterAnalytics/EPANET/issues/24/events","html_url":"https://github.com/OpenWaterAnalytics/EPANET/issues/24","id":106401609,"number":24,"title":"New functions documentation","user":{"login":"eladsal","id":1942312,"avatar_url":"https://avatars.githubusercontent.com/u/1942312?v=3","gravatar_id":"","url":"https://api.github.com/users/eladsal","html_url":"https://github.com/eladsal","followers_url":"https://api.github.com/users/eladsal/followers","following_url":"https://api.github.com/users/eladsal/following{/other_user}","gists_url":"https://api.github.com/users/eladsal/gists{/gist_id}","starred_url":"https://api.github.com/users/eladsal/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/eladsal/subscriptions","organizations_url":"https://api.github.com/users/eladsal/orgs","repos_url":"https://api.github.com/users/eladsal/repos","events_url":"https://api.github.com/users/eladsal/events{/privacy}","received_events_url":"https://api.github.com/users/eladsal/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/OpenWaterAnalytics/EPANET/labels/documentation","name":"documentation","color":"c7def8"}],"state":"open","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/OpenWaterAnalytics/EPANET/milestones/1","html_url":"https://github.com/OpenWaterAnalytics/EPANET/milestones/v2.1","labels_url":"https://api.github.com/repos/OpenWaterAnalytics/EPANET/milestones/1/labels","id":1157595,"number":1,"title":"v2.1","description":"","creator":{"login":"samhatchett","id":2386549,"avatar_url":"https://avatars.githubusercontent.com/u/2386549?v=3","gravatar_id":"","url":"https://api.github.com/users/samhatchett","html_url":"https://github.com/samhatchett","followers_url":"https://api.github.com/users/samhatchett/followers","following_url":"https://api.github.com/users/samhatchett/following{/other_user}","gists_url":"https://api.github.com/users/samhatchett/gists{/gist_id}","starred_url":"https://api.github.com/users/samhatchett/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/samhatchett/subscriptions","organizations_url":"https://api.github.com/users/samhatchett/orgs","repos_url":"https://api.github.com/users/samhatchett/repos","events_url":"https://api.github.com/users/samhatchett/events{/privacy}","received_events_url":"https://api.github.com/users/samhatchett/received_events","type":"User","site_admin":false},"open_issues":8,"closed_issues":5,"state":"open","created_at":"2015-06-09T21:24:08Z","updated_at":"2015-09-20T19:47:01Z","due_on":null,"closed_at":null},"comments":19,"created_at":"2015-09-14T18:33:56Z","updated_at":"2015-09-22T13:45:28Z","closed_at":null,"body":"Apart from the [changes documentation](https://github.com/OpenWaterAnalytics/EPANET/issues/14) I think we should document the new files added to the DLL. There are about 10 of them and I think that we could start with Wiki pages right here on GitHub."},"comment":{"url":"https://api.github.com/repos/OpenWaterAnalytics/EPANET/issues/comments/142293657","html_url":"https://github.com/OpenWaterAnalytics/EPANET/issues/24#issuecomment-142293657","issue_url":"https://api.github.com/repos/OpenWaterAnalytics/EPANET/issues/24","id":142293657,"user":{"login":"jamesuber","id":2408457,"avatar_url":"https://avatars.githubusercontent.com/u/2408457?v=3","gravatar_id":"","url":"https://api.github.com/users/jamesuber","html_url":"https://github.com/jamesuber","followers_url":"https://api.github.com/users/jamesuber/followers","following_url":"https://api.github.com/users/jamesuber/following{/other_user}","gists_url":"https://api.github.com/users/jamesuber/gists{/gist_id}","starred_url":"https://api.github.com/users/jamesuber/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jamesuber/subscriptions","organizations_url":"https://api.github.com/users/jamesuber/orgs","repos_url":"https://api.github.com/users/jamesuber/repos","events_url":"https://api.github.com/users/jamesuber/events{/privacy}","received_events_url":"https://api.github.com/users/jamesuber/received_events","type":"User","site_admin":false},"created_at":"2015-09-22T13:45:28Z","updated_at":"2015-09-22T13:45:28Z","body":"I think you are just saying that 99% of toolkit users will preferentially want to access something like a wiki for docs. We could debate that but ok. \n\nDoes that mean we should not use an inline doc system for the other 1%? Especially since the output of that process is what I'd consider to be critical and crucial basic reference documentation for the non-programmers too. \n\nAre you suggesting that the non-programmers don't want or need reference docs? If not that, then how should such ref info be generated and maintained? By looking at the code with my eyes and typing into the wiki with my fingers? 😉\n\nI'm just trying to shortcut to a hybrid solution that just seems obvious to me. \n\n\n> On Sep 22, 2015, at 8:48 AM, Elad Salomons <notifications@github.com> wrote:\n> \n> @jamesuber I would estimate that 99% of the Toolkit users are not programmers. Most of them might be engineers who write code :)\n> \n> I can't find the source rtf file of this pdf - anyone?\n> \n> —\n> Reply to this email directly or view it on GitHub.\n> \n"}}