{"action":"created","issue":{"url":"https://api.github.com/repos/eHealthAfrica/kazana/issues/90","labels_url":"https://api.github.com/repos/eHealthAfrica/kazana/issues/90/labels{/name}","comments_url":"https://api.github.com/repos/eHealthAfrica/kazana/issues/90/comments","events_url":"https://api.github.com/repos/eHealthAfrica/kazana/issues/90/events","html_url":"https://github.com/eHealthAfrica/kazana/issues/90","id":113886055,"number":90,"title":"[epic] Provide better documentation","user":{"login":"patriciagarcia","id":572958,"avatar_url":"https://avatars.githubusercontent.com/u/572958?v=3","gravatar_id":"","url":"https://api.github.com/users/patriciagarcia","html_url":"https://github.com/patriciagarcia","followers_url":"https://api.github.com/users/patriciagarcia/followers","following_url":"https://api.github.com/users/patriciagarcia/following{/other_user}","gists_url":"https://api.github.com/users/patriciagarcia/gists{/gist_id}","starred_url":"https://api.github.com/users/patriciagarcia/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/patriciagarcia/subscriptions","organizations_url":"https://api.github.com/users/patriciagarcia/orgs","repos_url":"https://api.github.com/users/patriciagarcia/repos","events_url":"https://api.github.com/users/patriciagarcia/events{/privacy}","received_events_url":"https://api.github.com/users/patriciagarcia/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/eHealthAfrica/kazana/labels/in%20progress","name":"in progress","color":"ededed"},{"url":"https://api.github.com/repos/eHealthAfrica/kazana/labels/retrospective","name":"retrospective","color":"d4c5f9"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":5,"created_at":"2015-10-28T18:07:35Z","updated_at":"2015-11-24T17:00:49Z","closed_at":null,"body":"The Kazana documentation is not very friendly for beginners:\n- documentation is spread over several documents\n- some things are outdated or missing\n- there is no much documentation about architecture\n- the kazana example is outdated\n- no information about how to report bugs\n- no information about contribution guidelines\n- not very extensive documentation about .kazanarc\n- not very extensive documentation about architecture\n- documentation in why decisions were made will be useful\n- frequently asked questions can be compiled in a dedicated page\n\nIt would be nice to compile all information in a dedicated Kazana page.\n\nAlso, we should make a point of answering questions by other developers by creating documentation that responds to the question (instead of just explaining that person in particular). This way we'll keep improving our docs, and making them easier to get for beginners."},"comment":{"url":"https://api.github.com/repos/eHealthAfrica/kazana/issues/comments/159339458","html_url":"https://github.com/eHealthAfrica/kazana/issues/90#issuecomment-159339458","issue_url":"https://api.github.com/repos/eHealthAfrica/kazana/issues/90","id":159339458,"user":{"login":"patriciagarcia","id":572958,"avatar_url":"https://avatars.githubusercontent.com/u/572958?v=3","gravatar_id":"","url":"https://api.github.com/users/patriciagarcia","html_url":"https://github.com/patriciagarcia","followers_url":"https://api.github.com/users/patriciagarcia/followers","following_url":"https://api.github.com/users/patriciagarcia/following{/other_user}","gists_url":"https://api.github.com/users/patriciagarcia/gists{/gist_id}","starred_url":"https://api.github.com/users/patriciagarcia/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/patriciagarcia/subscriptions","organizations_url":"https://api.github.com/users/patriciagarcia/orgs","repos_url":"https://api.github.com/users/patriciagarcia/repos","events_url":"https://api.github.com/users/patriciagarcia/events{/privacy}","received_events_url":"https://api.github.com/users/patriciagarcia/received_events","type":"User","site_admin":false},"created_at":"2015-11-24T17:00:49Z","updated_at":"2015-11-24T17:00:49Z","body":"Related https://github.com/eHealthAfrica/kazana/issues/69"}}