)]}'
{"doc/source/guidedreview.rst":[{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"cf9f8edfedb7eca453a0830c4120a026e05c16bf","unresolved":false,"context_lines":[{"line_number":8,"context_line":"project align with the guidelines?\" and are intended to be hosted by the"},{"line_number":9,"context_line":"working group at the PTG meetups."},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"On a more concrete level, the working group expects that reviews which are"},{"line_number":12,"context_line":"directed towards specific areas, or problems within, an API will garner the"},{"line_number":13,"context_line":"best results (e.g. \"Is using a PUT request for updating these resources"},{"line_number":14,"context_line":"appropriate?\", \"We are using GET requests to start server actions, is there a"}],"source_content_type":"text/x-rst","patch_set":3,"id":"df3967d1_7125d45b","line":11,"range":{"start_line":11,"start_character":0,"end_line":11,"end_character":24},"updated":"2017-08-03 15:29:48.000000000","message":"This is excellent. Too often guides are much too abstract.","commit_id":"7b6a05670ab93f632fcbc25ecde8e807f6d63105"},{"author":{"_account_id":10239,"name":"Dmitry Tantsur","email":"dtantsur@protonmail.com","username":"dtantsur"},"change_message_id":"1a0a2e3a733f1cbfee8ec2d323b074e18e3c0fbe","unresolved":false,"context_lines":[{"line_number":37,"context_line":"Here are some things you should prepare before approaching the API working"},{"line_number":38,"context_line":"group for a live review of your project:"},{"line_number":39,"context_line":""},{"line_number":40,"context_line":"1. Pick an area of your API to focus on (e.g. a specifc resource type, an"},{"line_number":41,"context_line":"   interaction that is troublesome or endpoints that could use clarification)."},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"2. Prepare a document describing the API in question, this could be free-form"}],"source_content_type":"text/x-rst","patch_set":3,"id":"df3967d1_2cdc8fe2","line":40,"updated":"2017-08-03 15:58:01.000000000","message":"nit: typo in specific","commit_id":"7b6a05670ab93f632fcbc25ecde8e807f6d63105"},{"author":{"_account_id":10239,"name":"Dmitry Tantsur","email":"dtantsur@protonmail.com","username":"dtantsur"},"change_message_id":"1a0a2e3a733f1cbfee8ec2d323b074e18e3c0fbe","unresolved":false,"context_lines":[{"line_number":38,"context_line":"group for a live review of your project:"},{"line_number":39,"context_line":""},{"line_number":40,"context_line":"1. Pick an area of your API to focus on (e.g. a specifc resource type, an"},{"line_number":41,"context_line":"   interaction that is troublesome or endpoints that could use clarification)."},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"2. Prepare a document describing the API in question, this could be free-form"},{"line_number":44,"context_line":"   or something more formal like an OpenAPI specification. This does not need"}],"source_content_type":"text/x-rst","patch_set":3,"id":"df3967d1_0cd9cbf1","line":41,"updated":"2017-08-03 15:58:01.000000000","message":"I guess clarifying microversioning for specific endpoint(s) can be a topic too (e.g. this is what we struggle with ironic: how to position unversioned free-form dicts)","commit_id":"7b6a05670ab93f632fcbc25ecde8e807f6d63105"},{"author":{"_account_id":10670,"name":"Michael McCune","email":"elmiko@redhat.com","username":"mimccune"},"change_message_id":"8094d9a1f29832274cafa98f466b15a0489c278c","unresolved":false,"context_lines":[{"line_number":38,"context_line":"group for a live review of your project:"},{"line_number":39,"context_line":""},{"line_number":40,"context_line":"1. Pick an area of your API to focus on (e.g. a specifc resource type, an"},{"line_number":41,"context_line":"   interaction that is troublesome or endpoints that could use clarification)."},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"2. Prepare a document describing the API in question, this could be free-form"},{"line_number":44,"context_line":"   or something more formal like an OpenAPI specification. This does not need"}],"source_content_type":"text/x-rst","patch_set":3,"id":"df3967d1_fffaa672","line":41,"in_reply_to":"df3967d1_0cd9cbf1","updated":"2017-08-03 19:11:46.000000000","message":"i think that sounds reasonable. imo, it\u0027s probably best if the question you are asking is about the api and not about the specific implementation, but i have a feeling most of the api-wg members would be willing to bike shed a little.","commit_id":"7b6a05670ab93f632fcbc25ecde8e807f6d63105"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"0255ce43fbe6a53f26ccd1691dbd2c02673c3bfd","unresolved":false,"context_lines":[{"line_number":47,"context_line":"   in question."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"Then just show up to an API working group face-to-face session with your"},{"line_number":50,"context_line":"materials ready, sending an email ahead of time will help to ensure that the"},{"line_number":51,"context_line":"group is ready for your review but is not strictly necessary."},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"What should I expect from my review?"}],"source_content_type":"text/x-rst","patch_set":3,"id":"df3967d1_a6b9c0cc","line":50,"updated":"2017-08-03 15:13:39.000000000","message":"s/, s/. S/","commit_id":"7b6a05670ab93f632fcbc25ecde8e807f6d63105"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"0255ce43fbe6a53f26ccd1691dbd2c02673c3bfd","unresolved":false,"context_lines":[{"line_number":53,"context_line":"What should I expect from my review?"},{"line_number":54,"context_line":"------------------------------------"},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"The answer to this will vary slightly depending on the nature of your request"},{"line_number":57,"context_line":"to the working group. You should expect to have clarification on the basic"},{"line_number":58,"context_line":"question of how close your API follows the working group\u0027s guidelines. But,"},{"line_number":59,"context_line":"the depth of your review will depend entirely on how big a request is made of"}],"source_content_type":"text/x-rst","patch_set":3,"id":"df3967d1_46021471","line":56,"updated":"2017-08-03 15:13:39.000000000","message":"s/slightly//","commit_id":"7b6a05670ab93f632fcbc25ecde8e807f6d63105"},{"author":{"_account_id":10239,"name":"Dmitry Tantsur","email":"dtantsur@protonmail.com","username":"dtantsur"},"change_message_id":"1a0a2e3a733f1cbfee8ec2d323b074e18e3c0fbe","unresolved":false,"context_lines":[{"line_number":70,"context_line":"guidelines and have questions about specific areas of interest will find that"},{"line_number":71,"context_line":"their reviews will be more productive than open-ended questions which cover"},{"line_number":72,"context_line":"large portions of their API."},{"line_number":73,"context_line":""},{"line_number":74,"context_line":"Example Review"},{"line_number":75,"context_line":"--------------"},{"line_number":76,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"df3967d1_ece1e79c","line":73,"updated":"2017-08-03 15:58:01.000000000","message":"Should such outcomes be published somewhere as reference points for other teams? e.g. publish them in this repo: \"We\u0027ve discussed the \u003c..\u003e with \u003c..\u003e team. They wanted to clarify \u003c..\u003e. We agreed that the expected result is \u003c..\u003e, and the right way forward is \u003c..\u003e.?","commit_id":"7b6a05670ab93f632fcbc25ecde8e807f6d63105"},{"author":{"_account_id":10670,"name":"Michael McCune","email":"elmiko@redhat.com","username":"mimccune"},"change_message_id":"8094d9a1f29832274cafa98f466b15a0489c278c","unresolved":false,"context_lines":[{"line_number":70,"context_line":"guidelines and have questions about specific areas of interest will find that"},{"line_number":71,"context_line":"their reviews will be more productive than open-ended questions which cover"},{"line_number":72,"context_line":"large portions of their API."},{"line_number":73,"context_line":""},{"line_number":74,"context_line":"Example Review"},{"line_number":75,"context_line":"--------------"},{"line_number":76,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"df3967d1_9feddab8","line":73,"in_reply_to":"df3967d1_ece1e79c","updated":"2017-08-03 19:11:46.000000000","message":"great idea, i\u0027ll add this to the document","commit_id":"7b6a05670ab93f632fcbc25ecde8e807f6d63105"}],"doc/source/index.rst":[{"author":{"_account_id":10239,"name":"Dmitry Tantsur","email":"dtantsur@protonmail.com","username":"dtantsur"},"change_message_id":"1a0a2e3a733f1cbfee8ec2d323b074e18e3c0fbe","unresolved":false,"context_lines":[{"line_number":41,"context_line":"Guidelines"},{"line_number":42,"context_line":"----------"},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"The following topics address guidance related to the working group and"},{"line_number":45,"context_line":"its processes:"},{"line_number":46,"context_line":""},{"line_number":47,"context_line":".. toctree::"}],"source_content_type":"text/x-rst","patch_set":3,"id":"df3967d1_4cd353d6","line":44,"updated":"2017-08-03 15:58:01.000000000","message":"it\u0027s probably my English, but \"address guidance\" is not something I understand without guessing from the context..","commit_id":"7b6a05670ab93f632fcbc25ecde8e807f6d63105"}]}