{"action":"created","issue":{"url":"https://api.github.com/repos/boto/botocore/issues/710","labels_url":"https://api.github.com/repos/boto/botocore/issues/710/labels{/name}","comments_url":"https://api.github.com/repos/boto/botocore/issues/710/comments","events_url":"https://api.github.com/repos/boto/botocore/issues/710/events","html_url":"https://github.com/boto/botocore/pull/710","id":115122852,"number":710,"title":"Generate shared examples for API documentation","user":{"login":"JordonPhillips","id":2643092,"avatar_url":"https://avatars.githubusercontent.com/u/2643092?v=3","gravatar_id":"","url":"https://api.github.com/users/JordonPhillips","html_url":"https://github.com/JordonPhillips","followers_url":"https://api.github.com/users/JordonPhillips/followers","following_url":"https://api.github.com/users/JordonPhillips/following{/other_user}","gists_url":"https://api.github.com/users/JordonPhillips/gists{/gist_id}","starred_url":"https://api.github.com/users/JordonPhillips/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/JordonPhillips/subscriptions","organizations_url":"https://api.github.com/users/JordonPhillips/orgs","repos_url":"https://api.github.com/users/JordonPhillips/repos","events_url":"https://api.github.com/users/JordonPhillips/events{/privacy}","received_events_url":"https://api.github.com/users/JordonPhillips/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/boto/botocore/labels/needs-review","name":"needs-review","color":"5319e7"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":6,"created_at":"2015-11-04T18:54:45Z","updated_at":"2015-11-12T23:12:10Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/boto/botocore/pulls/710","html_url":"https://github.com/boto/botocore/pull/710","diff_url":"https://github.com/boto/botocore/pull/710.diff","patch_url":"https://github.com/boto/botocore/pull/710.patch"},"body":"This is an update of #617, addressing some comments there and adding in unit tests."},"comment":{"url":"https://api.github.com/repos/boto/botocore/issues/comments/156266501","html_url":"https://github.com/boto/botocore/pull/710#issuecomment-156266501","issue_url":"https://api.github.com/repos/boto/botocore/issues/710","id":156266501,"user":{"login":"kyleknap","id":4605355,"avatar_url":"https://avatars.githubusercontent.com/u/4605355?v=3","gravatar_id":"","url":"https://api.github.com/users/kyleknap","html_url":"https://github.com/kyleknap","followers_url":"https://api.github.com/users/kyleknap/followers","following_url":"https://api.github.com/users/kyleknap/following{/other_user}","gists_url":"https://api.github.com/users/kyleknap/gists{/gist_id}","starred_url":"https://api.github.com/users/kyleknap/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kyleknap/subscriptions","organizations_url":"https://api.github.com/users/kyleknap/orgs","repos_url":"https://api.github.com/users/kyleknap/repos","events_url":"https://api.github.com/users/kyleknap/events{/privacy}","received_events_url":"https://api.github.com/users/kyleknap/received_events","type":"User","site_admin":false},"created_at":"2015-11-12T23:12:10Z","updated_at":"2015-11-12T23:12:10Z","body":"Looks like you have a good idea on how to get this working. I had a few small comments, but I have one relatively larger comment which is in ``SharedExampleBuilder`` there is a lot of logic (in terms of traversing the parameters and writing out examples) is it possible you could share this logic with the [BaseExampleDocumenter](https://github.com/boto/botocore/blob/develop/botocore/docs/example.py#L17)? This class is able to handle some of the smaller edge cases you may be missing such as proper handling of indentation (as opposed to hardcoding spaces), handling of doubly nested structures, and actually writing it into the DocumentStructure as opposed to generating it all upfront and then writing it all at once to the DocumentStructure."}}