)]}'
{"specs/kilo/openstack-firstapp.rst":[{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"5beb0777336ac52301b546e1ea2106d93476646a","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"A guide will be written that will introduce the OpenStack API, while"},{"line_number":24,"context_line":"also showcasing an already written non-trivial Python application that"},{"line_number":25,"context_line":"utilizes as much of the OpenStack as possible."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Alternatives"},{"line_number":28,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"baa041b7_e477a09d","line":25,"updated":"2015-04-03 13:38:50.000000000","message":"You\u0027ve setup a separate stackforge repository for all the content - and now you ask to include it in openstack-manuals. Please explain why the original repo is not good enough and why this needs to go into openstack-manuals.","commit_id":"10dbd98343eaf472bdb73a0aadafe9dbf3042d0d"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"e38b0318dc7411cfa89d8718d8d8616f3ed753a1","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"A guide will be written that will introduce the OpenStack API, while"},{"line_number":24,"context_line":"also showcasing an already written non-trivial Python application that"},{"line_number":25,"context_line":"utilizes as much of the OpenStack as possible."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Alternatives"},{"line_number":28,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9aa53dc9_8c53fde1","line":25,"in_reply_to":"9aa53dc9_a8a03b44","updated":"2015-04-10 08:15:01.000000000","message":"The repository on Stackforge (https://github.com/stackforge/faafo) only contains the First App Application for OpenStack, not the documentation created during the sprint itself. The documentation created during the sprint documents how to use the OpenStack API and the OpenStack SDKs. I placed the repository on Stackforge for maturing (I asked Anne and Andreas before adding the repository on Stackforge) with the intent to move the repository to the OpenStack namespace in the future.","commit_id":"10dbd98343eaf472bdb73a0aadafe9dbf3042d0d"},{"author":{"_account_id":4656,"name":"Sean M. Collins","email":"sean@coreitpro.com","username":"scollins"},"change_message_id":"ef2bb48d52b25f9f6aa4f27043f7ac95706e42b1","unresolved":false,"context_lines":[{"line_number":22,"context_line":""},{"line_number":23,"context_line":"A guide will be written that will introduce the OpenStack API, while"},{"line_number":24,"context_line":"also showcasing an already written non-trivial Python application that"},{"line_number":25,"context_line":"utilizes as much of the OpenStack as possible."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Alternatives"},{"line_number":28,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9aa53dc9_a8a03b44","line":25,"in_reply_to":"baa041b7_e477a09d","updated":"2015-04-08 14:21:52.000000000","message":"At least at the sprint, faafo was used for the example application, and the book content was placed into the following GitHub repo:\n\nhttps://github.com/fifieldt/openstack-firstapp\n\nI did not make this decision, you would have to ask Tom.","commit_id":"10dbd98343eaf472bdb73a0aadafe9dbf3042d0d"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"fbcb7d30b6a6bb2537c1e75df43c16558165d788","unresolved":false,"context_lines":[{"line_number":33,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"Tom Fifield has organized a sprint in Taipei, for one week, in order"},{"line_number":36,"context_line":"to have authors write content."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"Assignee(s)"},{"line_number":39,"context_line":"-----------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9aa53dc9_cda9a8e1","line":36,"updated":"2015-04-06 17:53:25.000000000","message":"I think you can describe more here about what will be delivered and where and how. \n\n\"The team will write a tutorial that covers these APIs:\nCompute v2\nIdentity v2.0\nImage v1.0\nObject Storage v1.0\n....\"\n\n\"The content will be written in RST using Sphinx to build to developer.openstack.org.\"\n\n\"The content will be stored in the api-site repo in a new folder, firstapp-tutorial.\"\n\n\"The review team will be the openstack-docs-core review team.\" Or another if you like, just say here in the spec who will be good reviewers for this content.\n\n\"The content will be tested with these gate tests:\n- doc builds?\n- python scripts run?\n\nWill the fractal/image visualizer app that Christian wrote continue to live in Stackforge, or will you bring it in with the content itself?","commit_id":"10dbd98343eaf472bdb73a0aadafe9dbf3042d0d"},{"author":{"_account_id":4656,"name":"Sean M. Collins","email":"sean@coreitpro.com","username":"scollins"},"change_message_id":"ef2bb48d52b25f9f6aa4f27043f7ac95706e42b1","unresolved":false,"context_lines":[{"line_number":33,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"Tom Fifield has organized a sprint in Taipei, for one week, in order"},{"line_number":36,"context_line":"to have authors write content."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"Assignee(s)"},{"line_number":39,"context_line":"-----------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9aa53dc9_8871f7e2","line":36,"in_reply_to":"9aa53dc9_cda9a8e1","updated":"2015-04-08 14:21:52.000000000","message":"\u003e Will the fractal/image visualizer app that Christian wrote continue to live in Stackforge, or will you bring it in with the content itself?\n\nYou would have to consult Christian. I do not know.","commit_id":"10dbd98343eaf472bdb73a0aadafe9dbf3042d0d"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"e38b0318dc7411cfa89d8718d8d8616f3ed753a1","unresolved":false,"context_lines":[{"line_number":42,"context_line":"* Tom Fifield (tom@openstack.org)"},{"line_number":43,"context_line":"* James Dempsey (jamesd@catalyst.net.nz)"},{"line_number":44,"context_line":"* Nick Chase (nchase@mirantis.com)"},{"line_number":45,"context_line":"* Christian Berendt (christian@berendt.io)"},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"Work Items"},{"line_number":48,"context_line":"----------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9aa53dc9_ccdfc567","line":45,"updated":"2015-04-10 08:15:01.000000000","message":"Please use my company mail address here (berendt@b1-systems.de).","commit_id":"10dbd98343eaf472bdb73a0aadafe9dbf3042d0d"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"9673de78748d1cd3aa732175e917718bef73baaf","unresolved":false,"context_lines":[{"line_number":63,"context_line":"In addition, the authors have paid special attention that the first 3 sections"},{"line_number":64,"context_line":"should work almost regardless of OpenStack cloud configuration (basically"},{"line_number":65,"context_line":"Nova, Keystone and Glance are the only requirements, but neutron will be used"},{"line_number":66,"context_line":"if installed)."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"Repository Location"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7aaa499b_3d81444b","line":66,"updated":"2015-04-13 14:09:14.000000000","message":"Question that remain unanswered from patch set 3:\n\nWhich API versions are used?","commit_id":"7932b44af99b6f5fc8c0ba0ae8163e8a9ff35aa8"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"4c20fc668e8eeaf0be13d72053d3dcf1a4208e58","unresolved":false,"context_lines":[{"line_number":63,"context_line":"In addition, the authors have paid special attention that the first 3 sections"},{"line_number":64,"context_line":"should work almost regardless of OpenStack cloud configuration (basically"},{"line_number":65,"context_line":"Nova, Keystone and Glance are the only requirements, but neutron will be used"},{"line_number":66,"context_line":"if installed)."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"Repository Location"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7aaa499b_1951e70e","line":66,"in_reply_to":"7aaa499b_3d81444b","updated":"2015-04-13 23:49:26.000000000","message":"This is taken care of by the SDKs, which abstract this from the user - not something that can or should be addressed in this spec.","commit_id":"7932b44af99b6f5fc8c0ba0ae8163e8a9ff35aa8"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"9673de78748d1cd3aa732175e917718bef73baaf","unresolved":false,"context_lines":[{"line_number":82,"context_line":"The documentation inside the repository of the app describes how to use"},{"line_number":83,"context_line":"the app itself (how to create a development environment, example outputs, ..),"},{"line_number":84,"context_line":"not how to use OpenStack SDKs and the OpenStack API."},{"line_number":85,"context_line":""},{"line_number":86,"context_line":""},{"line_number":87,"context_line":"Multi-SDK support"},{"line_number":88,"context_line":"-----------------"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7aaa499b_dd902098","line":85,"updated":"2015-04-13 14:09:14.000000000","message":"Questions that remain unanswered:\nWho is the review team for the content?\nWho is the review team for the app?\nWhich gate tests will be run?","commit_id":"7932b44af99b6f5fc8c0ba0ae8163e8a9ff35aa8"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"9673de78748d1cd3aa732175e917718bef73baaf","unresolved":false,"context_lines":[{"line_number":90,"context_line":"The guide has been written so that support for multiple SDKs is a core part of"},{"line_number":91,"context_line":"its publication. Initial sections have been written for libcloud, and section1"},{"line_number":92,"context_line":"is also available for fog. The design philosophy is that the same prose can be"},{"line_number":93,"context_line":"used, with code samples swapped."},{"line_number":94,"context_line":""},{"line_number":95,"context_line":""},{"line_number":96,"context_line":"Assignee(s)"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7aaa499b_ec6a101a","line":93,"updated":"2015-04-13 14:09:14.000000000","message":"Have you thought through the web dev you\u0027ll need for this? There are Sphinx extensions that can do this. Not necessarily in scope for this spec but want to be sure you know.","commit_id":"7932b44af99b6f5fc8c0ba0ae8163e8a9ff35aa8"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"4c20fc668e8eeaf0be13d72053d3dcf1a4208e58","unresolved":false,"context_lines":[{"line_number":90,"context_line":"The guide has been written so that support for multiple SDKs is a core part of"},{"line_number":91,"context_line":"its publication. Initial sections have been written for libcloud, and section1"},{"line_number":92,"context_line":"is also available for fog. The design philosophy is that the same prose can be"},{"line_number":93,"context_line":"used, with code samples swapped."},{"line_number":94,"context_line":""},{"line_number":95,"context_line":""},{"line_number":96,"context_line":"Assignee(s)"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7aaa499b_59476f4b","line":93,"in_reply_to":"7aaa499b_ec6a101a","updated":"2015-04-13 23:49:26.000000000","message":"Yes - it all works fine with standard sphinx, nothing special is needed","commit_id":"7932b44af99b6f5fc8c0ba0ae8163e8a9ff35aa8"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"9673de78748d1cd3aa732175e917718bef73baaf","unresolved":false,"context_lines":[{"line_number":105,"context_line":"Work Items"},{"line_number":106,"context_line":"----------"},{"line_number":107,"context_line":""},{"line_number":108,"context_line":"* Write content during the sprint"},{"line_number":109,"context_line":""},{"line_number":110,"context_line":""},{"line_number":111,"context_line":"Dependencies"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7aaa499b_5d0f70e1","line":108,"updated":"2015-04-13 14:09:14.000000000","message":"I don\u0027t believe you\u0027ve adequately captured the rest of the work items still needed:\n- Web dev for displaying multiple samples?\n- Gate tests for testing samples?\n- Additional editing before publishing (I read through section one and found a grammatical error, for example, are you expecting the content is fine as-is, and what review team will say so?)\n - Also, which sphinx theme will be used for the publishing? We don\u0027t really have a \"theme\" for developer.openstack.org.\n- Build jobs in infra.\n- Consideration for where it is linked from on landing page for developer.openstack.org.\n\nI\u0027d like to see assignees next to each item, or a justification for why the item doesn\u0027t need to be completed for this first publication. In my mind, at the very least to approve this spec, please indicate whether you\u0027ll use oslosphinx and where you will link to it from the landing page of developer.openstack.org.","commit_id":"7932b44af99b6f5fc8c0ba0ae8163e8a9ff35aa8"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"4c20fc668e8eeaf0be13d72053d3dcf1a4208e58","unresolved":false,"context_lines":[{"line_number":105,"context_line":"Work Items"},{"line_number":106,"context_line":"----------"},{"line_number":107,"context_line":""},{"line_number":108,"context_line":"* Write content during the sprint"},{"line_number":109,"context_line":""},{"line_number":110,"context_line":""},{"line_number":111,"context_line":"Dependencies"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7aaa499b_d9713faa","line":108,"in_reply_to":"7aaa499b_5d0f70e1","updated":"2015-04-13 23:49:26.000000000","message":"no web dev is needed\n\nsamples should be tested in review modification, just like the install guide at the moment and basically all other documentation\n\nI\u0027ll update the list for other jobs","commit_id":"7932b44af99b6f5fc8c0ba0ae8163e8a9ff35aa8"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"9673de78748d1cd3aa732175e917718bef73baaf","unresolved":false,"context_lines":[{"line_number":119,"context_line":""},{"line_number":120,"context_line":"The guide is written in such a way that all examples can"},{"line_number":121,"context_line":"be run by the reader, and steps have been taken to verify that"},{"line_number":122,"context_line":"all content is valid."},{"line_number":123,"context_line":""},{"line_number":124,"context_line":""},{"line_number":125,"context_line":"References"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7aaa499b_1d42083f","line":122,"updated":"2015-04-13 14:09:14.000000000","message":"Discuss here any gate tests to ensure the app itself still works for every patchset. Is that possible? Have you considered it and rejected or accepted the idea? If so who will do the work?","commit_id":"7932b44af99b6f5fc8c0ba0ae8163e8a9ff35aa8"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"4c20fc668e8eeaf0be13d72053d3dcf1a4208e58","unresolved":false,"context_lines":[{"line_number":119,"context_line":""},{"line_number":120,"context_line":"The guide is written in such a way that all examples can"},{"line_number":121,"context_line":"be run by the reader, and steps have been taken to verify that"},{"line_number":122,"context_line":"all content is valid."},{"line_number":123,"context_line":""},{"line_number":124,"context_line":""},{"line_number":125,"context_line":"References"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7aaa499b_595e4f13","line":122,"in_reply_to":"7aaa499b_1d42083f","updated":"2015-04-13 23:49:26.000000000","message":"Requiring gate tests for this document is a higher bar than is currently required of any other OpenStack document I\u0027m aware of. Think of this a bit like the install guide - which is thoroughly tested but does not have gate tests to do so.","commit_id":"7932b44af99b6f5fc8c0ba0ae8163e8a9ff35aa8"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"96808a515aa3733e6d159236cbbf0f41f06fdb4a","unresolved":false,"context_lines":[{"line_number":83,"context_line":"the app itself (how to create a development environment, example outputs, ..),"},{"line_number":84,"context_line":"not how to use OpenStack SDKs and the OpenStack API."},{"line_number":85,"context_line":""},{"line_number":86,"context_line":"As such, content will live in openstack-api-site like other documents"},{"line_number":87,"context_line":"published to developer.openstack.org. Therefore the review team will be the"},{"line_number":88,"context_line":"standard docs reviewers for this repository."},{"line_number":89,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"3ab451fb_5404027d","line":86,"updated":"2015-04-17 08:44:34.000000000","message":"openstack/api-site repository","commit_id":"e6cc2f790e22d54966dea5f477cce8a0c573a7eb"}]}