{"action":"created","issue":{"url":"https://api.github.com/repos/ory/hydra/issues/385","repository_url":"https://api.github.com/repos/ory/hydra","labels_url":"https://api.github.com/repos/ory/hydra/issues/385/labels{/name}","comments_url":"https://api.github.com/repos/ory/hydra/issues/385/comments","events_url":"https://api.github.com/repos/ory/hydra/issues/385/events","html_url":"https://github.com/ory/hydra/issues/385","id":209998549,"number":385,"title":"Let's improve the docs!","user":{"login":"arekkas","id":3372410,"avatar_url":"https://avatars7.githubusercontent.com/u/3372410?v=4","gravatar_id":"","url":"https://api.github.com/users/arekkas","html_url":"https://github.com/arekkas","followers_url":"https://api.github.com/users/arekkas/followers","following_url":"https://api.github.com/users/arekkas/following{/other_user}","gists_url":"https://api.github.com/users/arekkas/gists{/gist_id}","starred_url":"https://api.github.com/users/arekkas/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/arekkas/subscriptions","organizations_url":"https://api.github.com/users/arekkas/orgs","repos_url":"https://api.github.com/users/arekkas/repos","events_url":"https://api.github.com/users/arekkas/events{/privacy}","received_events_url":"https://api.github.com/users/arekkas/received_events","type":"User","site_admin":false},"labels":[{"id":300839958,"url":"https://api.github.com/repos/ory/hydra/labels/discuss","name":"discuss","color":"bfe5bf","default":false},{"id":384568282,"url":"https://api.github.com/repos/ory/hydra/labels/docs","name":"docs","color":"006b75","default":false},{"id":214764872,"url":"https://api.github.com/repos/ory/hydra/labels/help%20wanted","name":"help wanted","color":"159818","default":true}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":{"url":"https://api.github.com/repos/ory/hydra/milestones/10","html_url":"https://github.com/ory/hydra/milestone/10","labels_url":"https://api.github.com/repos/ory/hydra/milestones/10/labels","id":1954490,"number":10,"title":"unplanned","description":"","creator":{"login":"arekkas","id":3372410,"avatar_url":"https://avatars7.githubusercontent.com/u/3372410?v=4","gravatar_id":"","url":"https://api.github.com/users/arekkas","html_url":"https://github.com/arekkas","followers_url":"https://api.github.com/users/arekkas/followers","following_url":"https://api.github.com/users/arekkas/following{/other_user}","gists_url":"https://api.github.com/users/arekkas/gists{/gist_id}","starred_url":"https://api.github.com/users/arekkas/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/arekkas/subscriptions","organizations_url":"https://api.github.com/users/arekkas/orgs","repos_url":"https://api.github.com/users/arekkas/repos","events_url":"https://api.github.com/users/arekkas/events{/privacy}","received_events_url":"https://api.github.com/users/arekkas/received_events","type":"User","site_admin":false},"open_issues":29,"closed_issues":14,"state":"open","created_at":"2016-08-22T07:47:47Z","updated_at":"2017-07-09T15:10:29Z","due_on":null,"closed_at":null},"comments":12,"created_at":"2017-02-24T09:27:03Z","updated_at":"2017-07-15T05:29:31Z","closed_at":null,"body":"It's awesome to see how Hydra is attracting more and more users, and that we're seeing production deployments pop up! We are really close to releasing the 1.0.0 version (officially stable) as we are observing a steadily declining bug report frequency.\r\n\r\nOne large issue still open is the documentation. OAuth2 can be very overwhelming and the consent flow is an additional complexity people have to understand. The policy concept adds another mandatory \"you have to understand this\".\r\n\r\nI would like to ask you, the community, what problems you faced when you first read the docs. Maybe you have ideas to improve that? Or better examples?\r\n\r\nYou could even create a PR - the docs are [here](https://github.com/ory/hydra/tree/master/docs). To run them, do:\r\n\r\n```\r\nnpm i -g gitbook-cli\r\ngitbook serve -http\r\n```\r\n\r\n### To do\r\n\r\n* [x] document all special scopes (offline, hydra, openid)\r\n* [ ] example with force-consent scope (maybe @waynerobinson could help here)\r\n* [ ] write walkthrough for GKE\r\n* [x] document groups"},"comment":{"url":"https://api.github.com/repos/ory/hydra/issues/comments/315511312","html_url":"https://github.com/ory/hydra/issues/385#issuecomment-315511312","issue_url":"https://api.github.com/repos/ory/hydra/issues/385","id":315511312,"user":{"login":"drozzy","id":140710,"avatar_url":"https://avatars6.githubusercontent.com/u/140710?v=4","gravatar_id":"","url":"https://api.github.com/users/drozzy","html_url":"https://github.com/drozzy","followers_url":"https://api.github.com/users/drozzy/followers","following_url":"https://api.github.com/users/drozzy/following{/other_user}","gists_url":"https://api.github.com/users/drozzy/gists{/gist_id}","starred_url":"https://api.github.com/users/drozzy/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/drozzy/subscriptions","organizations_url":"https://api.github.com/users/drozzy/orgs","repos_url":"https://api.github.com/users/drozzy/repos","events_url":"https://api.github.com/users/drozzy/events{/privacy}","received_events_url":"https://api.github.com/users/drozzy/received_events","type":"User","site_admin":false},"created_at":"2017-07-15T05:29:31Z","updated_at":"2017-07-15T05:29:31Z","body":"1. Maybe a guide \"for dummies\"? For people not familiar with crypto? For example, I read oauth2 spec and understand the flows, but this file just overwhelms me:\r\nhttps://github.com/ory/hydra-idp-react/blob/master/src/common/service/hydra.js\r\n2. If one is working in a different language to Node.js - they have to _re-implement_ hydra.js themselves. It seems like it is very important thing to understand. The [HTTP API reference](http://docs.hydra13.apiary.io/#) is not sufficient. I think maybe we need a dedicated section about HTTP API.\r\n3. Perhaps a better documentation for the [sample app](https://github.com/ory/hydra-idp-react)? \r\n4. Maybe can we drop in an actual identity provider docker container instead of a fake [userService.js](https://github.com/ory/hydra-idp-react/blob/master/src/common/service/userService.js)?\r\n"}}
{"actor":{"display_login":"drozzy"}}