)]}'
{"specs/mitaka/api-guides-mitaka-vision.rst":[{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"1eb207634b48dfbb206d364856f6e10c653d6e89","unresolved":false,"context_lines":[{"line_number":11,"context_line":"Include the URL of your launchpad blueprint:"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"https://blueprints.launchpad.net/openstack-manuals/+spec/api-guides-mitaka-vision"},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"We want to build comprehensive app developer documentation for public-facing"},{"line_number":16,"context_line":"REST APIs for OpenStack. This goal can be achieved by creating developer guides"},{"line_number":17,"context_line":"for consumers to successfully build cloud-native applications. These developer"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_16615105","line":14,"updated":"2015-11-18 14:15:39.000000000","message":"Changing name to app-guides-mitaka-vision to further indicate the purpose.","commit_id":"8b84731e8e550fa395dcffc232fa42d15417acf3"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"3b583b868ad76847624035a48276affe3d6af810","unresolved":false,"context_lines":[{"line_number":29,"context_line":"- giving application developers information based on their language of choice"},{"line_number":30,"context_line":"- sourcing information about service capabilities and REST APIs through each"},{"line_number":31,"context_line":"service repo itself"},{"line_number":32,"context_line":"- ensuring that the \"First App on OpenStack\" is a complete first guide"},{"line_number":33,"context_line":"- automating the generation of API reference information"},{"line_number":34,"context_line":"- creating excellent, helpful, accurate, sufficient app developer guides"},{"line_number":35,"context_line":"- standardizing with the API Working Group doc guidelines in mind"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_bcbf23fa","line":32,"updated":"2015-11-18 02:24:39.000000000","message":"I think we should treat the First App guide in the same way we treat the Install Guide. However, that means we hold it to testing and release with each cycle. Is that possible?","commit_id":"8b84731e8e550fa395dcffc232fa42d15417acf3"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"430e0f6c9f1bef9f4ac6a99ca4094bdec66c68fb","unresolved":false,"context_lines":[{"line_number":29,"context_line":"- giving application developers information based on their language of choice"},{"line_number":30,"context_line":"- sourcing information about service capabilities and REST APIs through each"},{"line_number":31,"context_line":"service repo itself"},{"line_number":32,"context_line":"- ensuring that the \"First App on OpenStack\" is a complete first guide"},{"line_number":33,"context_line":"- automating the generation of API reference information"},{"line_number":34,"context_line":"- creating excellent, helpful, accurate, sufficient app developer guides"},{"line_number":35,"context_line":"- standardizing with the API Working Group doc guidelines in mind"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_ff035d40","line":32,"in_reply_to":"ba8a016a_bcbf23fa","updated":"2015-11-18 03:41:13.000000000","message":"@Lana: This is a very good point.\n\nTesting is extremely important for this guide, and at least I\u0027m personally committed to not publishing any SDK\u0027s version of the guide on the main site until it\u0027s been tested on several clouds (6 is my happy minimum number).\n\nHowever, noting that by \"complete\", we want to get five to seven SDK versions up, as well as markedly improving some sections, so it might be a bit more fast and loose in Mitaka than the next cycle.\n\nThe cool thing about working via SDKs and APIs is that they tend to be a whole lot more robust when it comes to using docs across versions. For example, the libcloud guide works across Juno, Kilo and Liberty - probably even more versions, too :) So, maybe we don\u0027t even need to lock it to a particular release? Answering that will require some investigation, but probably a N-release thing?","commit_id":"8b84731e8e550fa395dcffc232fa42d15417acf3"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"1eb207634b48dfbb206d364856f6e10c653d6e89","unresolved":false,"context_lines":[{"line_number":29,"context_line":"- giving application developers information based on their language of choice"},{"line_number":30,"context_line":"- sourcing information about service capabilities and REST APIs through each"},{"line_number":31,"context_line":"service repo itself"},{"line_number":32,"context_line":"- ensuring that the \"First App on OpenStack\" is a complete first guide"},{"line_number":33,"context_line":"- automating the generation of API reference information"},{"line_number":34,"context_line":"- creating excellent, helpful, accurate, sufficient app developer guides"},{"line_number":35,"context_line":"- standardizing with the API Working Group doc guidelines in mind"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_9128eb87","line":32,"in_reply_to":"ba8a016a_ff035d40","updated":"2015-11-18 14:15:39.000000000","message":"Right, I don\u0027t think it\u0027s quite like testing the install guide, because it spans multiple versions of OpenStack, but especially because it is feasible to automate the testing. We can look into that in a future release, not in the scope for now. \n\nThe first app is super prescriptive. Though even libcloud currently has to use the neutron CLI at one point. So it has a ways to go and I know Tom is fostering it in the right way.","commit_id":"8b84731e8e550fa395dcffc232fa42d15417acf3"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"3b583b868ad76847624035a48276affe3d6af810","unresolved":false,"context_lines":[{"line_number":34,"context_line":"- creating excellent, helpful, accurate, sufficient app developer guides"},{"line_number":35,"context_line":"- standardizing with the API Working Group doc guidelines in mind"},{"line_number":36,"context_line":"- aiming for organization of app developers tasks and workflow, rather than a"},{"line_number":37,"context_line":"\"service-first\" optimization"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":""},{"line_number":40,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_3c425311","line":37,"updated":"2015-11-18 02:24:39.000000000","message":"How would you do that (and maintain it)?","commit_id":"8b84731e8e550fa395dcffc232fa42d15417acf3"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"430e0f6c9f1bef9f4ac6a99ca4094bdec66c68fb","unresolved":false,"context_lines":[{"line_number":34,"context_line":"- creating excellent, helpful, accurate, sufficient app developer guides"},{"line_number":35,"context_line":"- standardizing with the API Working Group doc guidelines in mind"},{"line_number":36,"context_line":"- aiming for organization of app developers tasks and workflow, rather than a"},{"line_number":37,"context_line":"\"service-first\" optimization"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":""},{"line_number":40,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_7f968df1","line":37,"in_reply_to":"ba8a016a_3c425311","updated":"2015-11-18 03:41:13.000000000","message":"I think this just means that we talk about things from an app dev perspective, which typically ranges across many of the services clouds have to offer, right?","commit_id":"8b84731e8e550fa395dcffc232fa42d15417acf3"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"1eb207634b48dfbb206d364856f6e10c653d6e89","unresolved":false,"context_lines":[{"line_number":34,"context_line":"- creating excellent, helpful, accurate, sufficient app developer guides"},{"line_number":35,"context_line":"- standardizing with the API Working Group doc guidelines in mind"},{"line_number":36,"context_line":"- aiming for organization of app developers tasks and workflow, rather than a"},{"line_number":37,"context_line":"\"service-first\" optimization"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":""},{"line_number":40,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_d1499361","line":37,"in_reply_to":"ba8a016a_7f968df1","updated":"2015-11-18 14:15:39.000000000","message":"I\u0027m glad you caught this. We\u0027ll need to consider pulling in the Python SDK chapter from the user guide.","commit_id":"8b84731e8e550fa395dcffc232fa42d15417acf3"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"430e0f6c9f1bef9f4ac6a99ca4094bdec66c68fb","unresolved":false,"context_lines":[{"line_number":41,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"With these general guidelines in mind, let\u0027s build a new guide from multiple"},{"line_number":44,"context_line":"sources with this outline:"},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"* Introduction to OpenStack REST APIs"},{"line_number":47,"context_line":"* Building your First App on OpenStack"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_7f4bed87","line":44,"updated":"2015-11-18 03:41:13.000000000","message":"I\u0027m confused about how this will look :) Is the below in one book with a long nav bar down the side, including the API reference which has traditionally been a bit different than the prose?","commit_id":"8b84731e8e550fa395dcffc232fa42d15417acf3"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"1eb207634b48dfbb206d364856f6e10c653d6e89","unresolved":false,"context_lines":[{"line_number":41,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"With these general guidelines in mind, let\u0027s build a new guide from multiple"},{"line_number":44,"context_line":"sources with this outline:"},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"* Introduction to OpenStack REST APIs"},{"line_number":47,"context_line":"* Building your First App on OpenStack"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_b66ac5ec","line":44,"in_reply_to":"ba8a016a_7f4bed87","updated":"2015-11-18 14:15:39.000000000","message":"We\u0027ll have to work with Russell to see what\u0027s possible. Right now the prototype is per-service. I\u0027d like to change this, and integrate the API Reference much more as a piece of the larger picture.","commit_id":"8b84731e8e550fa395dcffc232fa42d15417acf3"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"3b583b868ad76847624035a48276affe3d6af810","unresolved":false,"context_lines":[{"line_number":49,"context_line":""},{"line_number":50,"context_line":"  * Authenticate as a user"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"* Images API"},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"  * Manage images"},{"line_number":55,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_5c45d714","line":52,"updated":"2015-11-18 02:24:39.000000000","message":"This is still services-based, not task based.","commit_id":"8b84731e8e550fa395dcffc232fa42d15417acf3"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"1eb207634b48dfbb206d364856f6e10c653d6e89","unresolved":false,"context_lines":[{"line_number":49,"context_line":""},{"line_number":50,"context_line":"  * Authenticate as a user"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"* Images API"},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"  * Manage images"},{"line_number":55,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba8a016a_167ab1bd","line":52,"in_reply_to":"ba8a016a_5c45d714","updated":"2015-11-18 14:15:39.000000000","message":"Good catch, changing titles.","commit_id":"8b84731e8e550fa395dcffc232fa42d15417acf3"}],"specs/mitaka/app-guides-mitaka-vision.rst":[{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"d4c58c04f625159b3537d437879103ab096d5a97","unresolved":false,"context_lines":[{"line_number":8,"context_line":"Application Developer Guides - aka API Guides"},{"line_number":9,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Include the URL of your launchpad blueprint:"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"https://blueprints.launchpad.net/openstack-manuals/+spec/app-guides-mitaka-vision"},{"line_number":14,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba8a016a_53280433","line":11,"updated":"2015-11-19 15:35:48.000000000","message":"Remove the above line","commit_id":"075a9e6a1d1200cb008562bcc7f7abb6b8a10649"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"d4c58c04f625159b3537d437879103ab096d5a97","unresolved":false,"context_lines":[{"line_number":25,"context_line":"need much more information than simply API documentation. With the API"},{"line_number":26,"context_line":"reference information as an article in the collection of information, we can"},{"line_number":27,"context_line":"better serve this audience through developer.openstack.org by:"},{"line_number":28,"context_line":"- updating the landing page for developer.openstack.org"},{"line_number":29,"context_line":"- giving application developers information based on their language of choice"},{"line_number":30,"context_line":"- sourcing information about service capabilities and REST APIs through each"},{"line_number":31,"context_line":"service repo itself"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba8a016a_9332eca5","line":28,"updated":"2015-11-19 15:35:48.000000000","message":"add empty line before this, otherwise this does not render nicely","commit_id":"075a9e6a1d1200cb008562bcc7f7abb6b8a10649"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"d4c58c04f625159b3537d437879103ab096d5a97","unresolved":false,"context_lines":[{"line_number":115,"context_line":"    * api-ref info containing migrated Swagger/RST source files"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"How will consumers find and read these articles? From:"},{"line_number":118,"context_line":"http://developer.openstack.org"},{"line_number":119,"context_line":"http://developer.openstack.org/firstapp-libcloud/"},{"line_number":120,"context_line":"http://developer.openstack.org/api-guide/quick-start/"},{"line_number":121,"context_line":"http://developer.openstack.org/api-guide/compute/"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba8a016a_f3ea58da","line":118,"updated":"2015-11-19 15:35:48.000000000","message":"Make this a list","commit_id":"075a9e6a1d1200cb008562bcc7f7abb6b8a10649"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"d4c58c04f625159b3537d437879103ab096d5a97","unresolved":false,"context_lines":[{"line_number":154,"context_line":"Primary assignee:"},{"line_number":155,"context_line":"  russellsim Russell Sim"},{"line_number":156,"context_line":""},{"line_number":157,"context_line":"Other contributors:"},{"line_number":158,"context_line":"  annegentle Anne Gentle"},{"line_number":159,"context_line":"  etowes Everett Toews"},{"line_number":160,"context_line":"  sdague Sean Dague"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba8a016a_f3d1f823","line":157,"updated":"2015-11-19 15:35:48.000000000","message":"Better make it a list, see how it renders..","commit_id":"075a9e6a1d1200cb008562bcc7f7abb6b8a10649"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"d4c58c04f625159b3537d437879103ab096d5a97","unresolved":false,"context_lines":[{"line_number":164,"context_line":"Work Items"},{"line_number":165,"context_line":"----------"},{"line_number":166,"context_line":""},{"line_number":167,"context_line":"Revise landing page for developer.openstack.org - russellsim *"},{"line_number":168,"context_line":"Create landing page for developer.openstack.org/sdk - russellsim *"},{"line_number":169,"context_line":"Create documentation pages for developer.openstack.org/sdk/python/openstacksdk"},{"line_number":170,"context_line":"- etowes"}],"source_content_type":"text/x-rst","patch_set":2,"id":"ba8a016a_73a428b9","line":167,"updated":"2015-11-19 15:35:48.000000000","message":"Make a proper list - this is all one paragraph in HTML","commit_id":"075a9e6a1d1200cb008562bcc7f7abb6b8a10649"},{"author":{"_account_id":2448,"name":"Diane Fleming","email":"dfleming@austin.rr.com","username":"diane-fleming"},"change_message_id":"0459c38c3e357cf2b445a4ed7808400badc2cc4c","unresolved":false,"context_lines":[{"line_number":11,"context_line":"https://blueprints.launchpad.net/openstack-manuals/+spec/app-guides-mitaka-vision"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"We want to build comprehensive app developer documentation for public-facing"},{"line_number":14,"context_line":"REST APIs for OpenStack. This goal can be achieved by creating developer guides"},{"line_number":15,"context_line":"for consumers to successfully build cloud-native applications. These developer"},{"line_number":16,"context_line":"guides have conceptual articles, reference information, and how-to"},{"line_number":17,"context_line":"articles collected into one comprehensive guide on developer.openstack.org."}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba8a016a_144982d0","line":14,"updated":"2015-11-23 16:00:42.000000000","message":"for public-facing OpenStack REST APIs. The goal of these guides is to enable consumers to successfully build cloud-native applications.","commit_id":"783d5fc9f84f8d842612767b3709e41e0490d46c"},{"author":{"_account_id":2448,"name":"Diane Fleming","email":"dfleming@austin.rr.com","username":"diane-fleming"},"change_message_id":"0459c38c3e357cf2b445a4ed7808400badc2cc4c","unresolved":false,"context_lines":[{"line_number":13,"context_line":"We want to build comprehensive app developer documentation for public-facing"},{"line_number":14,"context_line":"REST APIs for OpenStack. This goal can be achieved by creating developer guides"},{"line_number":15,"context_line":"for consumers to successfully build cloud-native applications. These developer"},{"line_number":16,"context_line":"guides have conceptual articles, reference information, and how-to"},{"line_number":17,"context_line":"articles collected into one comprehensive guide on developer.openstack.org."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"Problem description"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba8a016a_7407ae1d","line":16,"updated":"2015-11-23 16:00:42.000000000","message":"Each comprehensive guide, delivered on developer.openstack.org,  contains xx, xx, xx, and xx.","commit_id":"783d5fc9f84f8d842612767b3709e41e0490d46c"},{"author":{"_account_id":2448,"name":"Diane Fleming","email":"dfleming@austin.rr.com","username":"diane-fleming"},"change_message_id":"0459c38c3e357cf2b445a4ed7808400badc2cc4c","unresolved":false,"context_lines":[{"line_number":19,"context_line":"Problem description"},{"line_number":20,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":21,"context_line":""},{"line_number":22,"context_line":"For years now we have published API documentation, but application developers"},{"line_number":23,"context_line":"need much more information than simply API documentation. With the API"},{"line_number":24,"context_line":"reference information as an article in the collection of information, we can"},{"line_number":25,"context_line":"better serve this audience through developer.openstack.org by:"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba8a016a_6f903b4f","line":22,"updated":"2015-11-23 16:00:42.000000000","message":"For years, we have published API references, but application developers also need conceptual information, how-to articles, and best practice information.","commit_id":"783d5fc9f84f8d842612767b3709e41e0490d46c"},{"author":{"_account_id":15409,"name":"Marcela Bonell","email":"marcelabonell@gmail.com","username":"mbonell"},"change_message_id":"2bc4e05e43ed20f990651c7e8d4170a291c0321e","unresolved":false,"context_lines":[{"line_number":24,"context_line":"reference information as an article in the collection of information, we can"},{"line_number":25,"context_line":"better serve this audience through developer.openstack.org by:"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"- updating the landing page for developer.openstack.org"},{"line_number":28,"context_line":"- giving application developers information based on their language of choice"},{"line_number":29,"context_line":"- sourcing information about service capabilities and REST APIs through each"},{"line_number":30,"context_line":"  service repo itself"}],"source_content_type":"text/x-rst","patch_set":4,"id":"ba8a016a_8b735715","line":27,"updated":"2015-11-20 16:03:55.000000000","message":"Looks very well!\nJust a comment, use capital letter at the beginning in this list to look as the other lists in the guide.","commit_id":"783d5fc9f84f8d842612767b3709e41e0490d46c"},{"author":{"_account_id":2448,"name":"Diane Fleming","email":"dfleming@austin.rr.com","username":"diane-fleming"},"change_message_id":"7193d375c921fb1c5c35d06b5534c0d17159153d","unresolved":false,"context_lines":[{"line_number":221,"context_line":"References"},{"line_number":222,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":223,"context_line":""},{"line_number":224,"context_line":"* http://specs.openstack.org/openstack/docs-specs/specs/liberty/api-site.html"},{"line_number":225,"context_line":""},{"line_number":226,"context_line":"* http://specs.openstack.org/openstack/api-wg/guidelines/api-docs.html"},{"line_number":227,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba8a016a_b008bb29","line":224,"updated":"2015-11-23 15:48:27.000000000","message":"Though I know this isn\u0027t the point of this review, I have some concerns about sourcing the API docs from the code itself. Some potential issues:\n\n- It takes a long time to patch code. For small changes, like typos, will this hold up the works?\n- What if the only code changes for a project in a release are doc changes? Do we cut a release of the code just for doc changes?\n- Developers are very unlikely (in my experience) to add embedded documentation to code and keep it up-to-date.\n- How might keeping doc strings in the code itself affect translation?\n- What happens to the doc core team when the doc source moves into code? Do doc core reviewers gain +2 approval access to code repositories?","commit_id":"d3c87c03affaf50e2180d50cbcb096ffc53d0668"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"d763b2c1a42a9255156e272fb5614a010672ee9f","unresolved":false,"context_lines":[{"line_number":221,"context_line":"References"},{"line_number":222,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":223,"context_line":""},{"line_number":224,"context_line":"* http://specs.openstack.org/openstack/docs-specs/specs/liberty/api-site.html"},{"line_number":225,"context_line":""},{"line_number":226,"context_line":"* http://specs.openstack.org/openstack/api-wg/guidelines/api-docs.html"},{"line_number":227,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a8ffd7b_233382f8","line":224,"in_reply_to":"ba8a016a_b008bb29","updated":"2015-11-30 14:02:55.000000000","message":"Agree with all these concerns. So, so much. But, only a handful of teams sound interested in embedding docs in code. Maybe 2-3 out of 30?\n\nIf teams want to hand over RST and Swagger to the api-site repo that\u0027s what\u0027ll build. We\u0027ll have less say in what they write, but it won\u0027t be published unless we +2. I do want to set up a separate team just for API docs, including the API working group, so will add that task to this spec.\n\nBasically we\u0027ll give everyone a framework... so I think the tradeoffs are okay. I sense we have to try and see.\n\nAnother idea would be to have an \"interim\" repo some where that an API team has +2 on, such as API writers and the API working group, then run tests that compare the completeness of generated Swagger to the \"truthful\" docs? Not sure it\u0027s worth all that. Basically api-site is still the \"source of published docs\" as far as I see it.","commit_id":"d3c87c03affaf50e2180d50cbcb096ffc53d0668"},{"author":{"_account_id":2448,"name":"Diane Fleming","email":"dfleming@austin.rr.com","username":"diane-fleming"},"change_message_id":"78eabfdcf920ca21c4c2402ace82350a67842647","unresolved":false,"context_lines":[{"line_number":221,"context_line":"References"},{"line_number":222,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":223,"context_line":""},{"line_number":224,"context_line":"* http://specs.openstack.org/openstack/docs-specs/specs/liberty/api-site.html"},{"line_number":225,"context_line":""},{"line_number":226,"context_line":"* http://specs.openstack.org/openstack/api-wg/guidelines/api-docs.html"},{"line_number":227,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"ba8a016a_ebcf38b1","line":224,"in_reply_to":"ba8a016a_b008bb29","updated":"2015-11-23 16:02:38.000000000","message":"Also, how do we move existing WADL information into the source code? Will this be automated?","commit_id":"d3c87c03affaf50e2180d50cbcb096ffc53d0668"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"d763b2c1a42a9255156e272fb5614a010672ee9f","unresolved":false,"context_lines":[{"line_number":221,"context_line":"References"},{"line_number":222,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":223,"context_line":""},{"line_number":224,"context_line":"* http://specs.openstack.org/openstack/docs-specs/specs/liberty/api-site.html"},{"line_number":225,"context_line":""},{"line_number":226,"context_line":"* http://specs.openstack.org/openstack/api-wg/guidelines/api-docs.html"},{"line_number":227,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a8ffd7b_983979f5","line":224,"in_reply_to":"ba8a016a_ebcf38b1","updated":"2015-11-30 14:02:55.000000000","message":"There\u0027s no plan or method to move existing WADL into source code, developers would have to do that. Honestly I don\u0027t believe most teams want to take it on, but we have to make it allowed for the 2-3 teams who may want to do this. (Nova, Ironic, Ceilometer come to mind).","commit_id":"d3c87c03affaf50e2180d50cbcb096ffc53d0668"},{"author":{"_account_id":15293,"name":"Karen Bradshaw","email":"kbhawkey@gmail.com","username":"karenb"},"change_message_id":"c1c31697ad4858b23509c8d12834473ed98310ce","unresolved":false,"context_lines":[{"line_number":58,"context_line":""},{"line_number":59,"context_line":"* Compute"},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"  * Launch an instance"},{"line_number":62,"context_line":"  * Provide user data to an instance"},{"line_number":63,"context_line":"  * Manage access and security"},{"line_number":64,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba8a016a_908fa522","line":61,"updated":"2015-11-23 21:48:18.000000000","message":"The tasks listed here per service will come in the form of individual API guides/service or will there be a different approach to represent the content?","commit_id":"7d63086e8f45d438e4e17fb47a2a1af28adc05ce"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"fb6be215d5d4d96ecf8bb77a21ae18b6624138e4","unresolved":false,"context_lines":[{"line_number":58,"context_line":""},{"line_number":59,"context_line":"* Compute"},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"  * Launch an instance"},{"line_number":62,"context_line":"  * Provide user data to an instance"},{"line_number":63,"context_line":"  * Manage access and security"},{"line_number":64,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a8ffd7b_18f029c9","line":61,"in_reply_to":"ba8a016a_908fa522","updated":"2015-11-30 14:03:21.000000000","message":"Hm. These tasks are... in the user guide now, but not as an API call. I envision they would be in individual API guides per service. Sourced in nova/api-guide in this case.","commit_id":"7d63086e8f45d438e4e17fb47a2a1af28adc05ce"},{"author":{"_account_id":15293,"name":"Karen Bradshaw","email":"kbhawkey@gmail.com","username":"karenb"},"change_message_id":"c1c31697ad4858b23509c8d12834473ed98310ce","unresolved":false,"context_lines":[{"line_number":84,"context_line":"  * Python"},{"line_number":85,"context_line":"  * Go"},{"line_number":86,"context_line":"  * .Net"},{"line_number":87,"context_line":"  * Java"},{"line_number":88,"context_line":"  * nodejs"},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"* API Complete References"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba8a016a_b02e69f8","line":87,"updated":"2015-11-23 21:48:18.000000000","message":"Is there a single SDK/language?  What Is the criteria to get an SDK listed on the developer page(completeness, quality, maturity)?","commit_id":"7d63086e8f45d438e4e17fb47a2a1af28adc05ce"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"fb6be215d5d4d96ecf8bb77a21ae18b6624138e4","unresolved":false,"context_lines":[{"line_number":84,"context_line":"  * Python"},{"line_number":85,"context_line":"  * Go"},{"line_number":86,"context_line":"  * .Net"},{"line_number":87,"context_line":"  * Java"},{"line_number":88,"context_line":"  * nodejs"},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"* API Complete References"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a8ffd7b_b8ea3dab","line":87,"in_reply_to":"ba8a016a_b02e69f8","updated":"2015-11-30 14:03:21.000000000","message":"There is not, and there is no criteria currently. We do list some on the developer.openstack.org landing page. \n\nMy vision is that there should be a large festival surrounding the \"big tent\" governance currently in place, and all SDKs should be welcomed. We\u0027ve already seen two SDKs wither in the gerrit system, so I\u0027d prefer that SDKs not submit to OpenStack governance unless there\u0027s a compelling reason, such as the Python SDK having a Python build system ready to go with OpenStack infra already.","commit_id":"7d63086e8f45d438e4e17fb47a2a1af28adc05ce"},{"author":{"_account_id":15293,"name":"Karen Bradshaw","email":"kbhawkey@gmail.com","username":"karenb"},"change_message_id":"c1c31697ad4858b23509c8d12834473ed98310ce","unresolved":false,"context_lines":[{"line_number":111,"context_line":"  * Object Storage"},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"* Best practices for apps on OpenStack"},{"line_number":114,"context_line":""},{"line_number":115,"context_line":"How will each section be sourced?"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"  * API Quick Start in the api-site repository"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba8a016a_d0776d00","line":114,"updated":"2015-11-23 21:48:18.000000000","message":"What will be the content format for Best practices and Troubleshooting?  Are `\u0027best practices`` covered in First App?","commit_id":"7d63086e8f45d438e4e17fb47a2a1af28adc05ce"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"fb6be215d5d4d96ecf8bb77a21ae18b6624138e4","unresolved":false,"context_lines":[{"line_number":111,"context_line":"  * Object Storage"},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"* Best practices for apps on OpenStack"},{"line_number":114,"context_line":""},{"line_number":115,"context_line":"How will each section be sourced?"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"  * API Quick Start in the api-site repository"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a8ffd7b_980ad978","line":114,"in_reply_to":"ba8a016a_d0776d00","updated":"2015-11-30 14:03:21.000000000","message":"First App doesn\u0027t necessarily have best practices as it\u0027s a true getting started, and first application guide. This could be written in RST, built with Sphinx.","commit_id":"7d63086e8f45d438e4e17fb47a2a1af28adc05ce"},{"author":{"_account_id":15293,"name":"Karen Bradshaw","email":"kbhawkey@gmail.com","username":"karenb"},"change_message_id":"c1c31697ad4858b23509c8d12834473ed98310ce","unresolved":false,"context_lines":[{"line_number":177,"context_line":"* Landing and web pages"},{"line_number":178,"context_line":""},{"line_number":179,"context_line":"  * Revise landing page for developer.openstack.org - russellsim *"},{"line_number":180,"context_line":"  * Create landing page for developer.openstack.org/sdk"},{"line_number":181,"context_line":"    - russellsim *"},{"line_number":182,"context_line":"  * Create web pages for"},{"line_number":183,"context_line":"    developer.openstack.org/sdk/python/openstacksdk - etowes"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba8a016a_b0cae918","line":180,"updated":"2015-11-23 21:48:18.000000000","message":"russelsim has an extra asterisk?","commit_id":"7d63086e8f45d438e4e17fb47a2a1af28adc05ce"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"fb6be215d5d4d96ecf8bb77a21ae18b6624138e4","unresolved":false,"context_lines":[{"line_number":177,"context_line":"* Landing and web pages"},{"line_number":178,"context_line":""},{"line_number":179,"context_line":"  * Revise landing page for developer.openstack.org - russellsim *"},{"line_number":180,"context_line":"  * Create landing page for developer.openstack.org/sdk"},{"line_number":181,"context_line":"    - russellsim *"},{"line_number":182,"context_line":"  * Create web pages for"},{"line_number":183,"context_line":"    developer.openstack.org/sdk/python/openstacksdk - etowes"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a8ffd7b_78229503","line":180,"in_reply_to":"ba8a016a_b0cae918","updated":"2015-11-30 14:03:21.000000000","message":"Heh, good catch.","commit_id":"7d63086e8f45d438e4e17fb47a2a1af28adc05ce"},{"author":{"_account_id":15293,"name":"Karen Bradshaw","email":"kbhawkey@gmail.com","username":"karenb"},"change_message_id":"c1c31697ad4858b23509c8d12834473ed98310ce","unresolved":false,"context_lines":[{"line_number":188,"context_line":"    Tom should keep communicating about it as he is. - fifieldt"},{"line_number":189,"context_line":"  * Ensure that APIs that support micro-versions display that"},{"line_number":190,"context_line":"    information - russellsim"},{"line_number":191,"context_line":""},{"line_number":192,"context_line":"* Publication jobs"},{"line_number":193,"context_line":""},{"line_number":194,"context_line":"  * Write publishing jobs to statically copy Swagger/RST reference"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba8a016a_10b1758f","line":191,"updated":"2015-11-23 21:48:18.000000000","message":"Will you provide detail about what content is static and what content requires a web server to display the content -- perhaps that will follow in another spec.?\nWhat about guidelines for maintaining the swagger/rst files and best practices for writing content(helps the display look consistent and permits better control of content in UI components)?","commit_id":"7d63086e8f45d438e4e17fb47a2a1af28adc05ce"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"fb6be215d5d4d96ecf8bb77a21ae18b6624138e4","unresolved":false,"context_lines":[{"line_number":188,"context_line":"    Tom should keep communicating about it as he is. - fifieldt"},{"line_number":189,"context_line":"  * Ensure that APIs that support micro-versions display that"},{"line_number":190,"context_line":"    information - russellsim"},{"line_number":191,"context_line":""},{"line_number":192,"context_line":"* Publication jobs"},{"line_number":193,"context_line":""},{"line_number":194,"context_line":"  * Write publishing jobs to statically copy Swagger/RST reference"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a8ffd7b_f8ca051a","line":191,"in_reply_to":"ba8a016a_10b1758f","updated":"2015-11-30 14:03:21.000000000","message":"We don\u0027t have a spec yet for infra to enable the server, so yes, that\u0027s in another spec, for the infra team. Russell is signed up to write it. For this release I\u0027m betting we\u0027ll need static-only. \n\nAh, good point. I was thinking that guidelines for maintaining the swagger and RST belong in the \"Communication: Document what teams can do to follow this pattern\" so I\u0027ll add that below.","commit_id":"7d63086e8f45d438e4e17fb47a2a1af28adc05ce"},{"author":{"_account_id":19181,"name":"David F Flanders","email":"dff.openstack@gmail.com","username":"DFFlanders"},"change_message_id":"7bf359482b3401e802041d5754e0357d322207ea","unresolved":false,"context_lines":[{"line_number":15,"context_line":"consumers to successfully build cloud-native applications. Each"},{"line_number":16,"context_line":"comprehensive guide, delivered on developer.openstack.org, will contain a"},{"line_number":17,"context_line":"collection of conceptual articles, reference information, and how-to"},{"line_number":18,"context_line":"articles."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"Problem description"},{"line_number":21,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":8,"id":"9a8ffd7b_3f3d57dd","line":18,"updated":"2015-12-02 11:36:33.000000000","message":"Should this goal also include *connecting developers together* so they can use these resources (articles, ref info, how-to, etc) as part of a community, i.e. go along to a training to learn how these resources are used, become part of a train-the-trainer network, attend a design summit, etc.?\n\nPoint being, is developer.openstack.org a place where developers \u0027end up\u0027 (working through resources on their own) or is it a \u0027means to an end\u0027 where they come to connect with the developer community?  I\u0027m sure it is both, but what do we want the single \u0027blink\u0027 message exuding from the page to be?\n\nI don\u0027t think this changes the scope below, but I do think it affects the overall assumption for why people make their way to this page and why they work through it - to benefit themselves via XYZ?","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"99b7e727ba08690319fcb0386084d39708f2ed9f","unresolved":false,"context_lines":[{"line_number":15,"context_line":"consumers to successfully build cloud-native applications. Each"},{"line_number":16,"context_line":"comprehensive guide, delivered on developer.openstack.org, will contain a"},{"line_number":17,"context_line":"collection of conceptual articles, reference information, and how-to"},{"line_number":18,"context_line":"articles."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"Problem description"},{"line_number":21,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":8,"id":"7a740942_c01d9574","line":18,"in_reply_to":"7a740942_16e9ce1a","updated":"2015-12-04 13:55:46.000000000","message":"I don\u0027t envision we can scope beyond static HTML with our current tools this release. \n\nRussell and I have engaged infra team members about provisioning a more dynamic server solution and have to create an infra spec to describe it. With a new doc publishing spec in infra from juno (http://specs.openstack.org/openstack-infra/infra-specs/specs/doc-publishing.html) still not implemented completely, I don\u0027t imagine they\u0027ll be able to prioritize it in time for the scope of this specification.","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":287,"name":"Stefano Maffulli \u0027reed\u0027","email":"stefano@openstack.org","username":"smaffulli"},"change_message_id":"39208f5c56eb7da900c5059a946c4fcbbc5cdf34","unresolved":false,"context_lines":[{"line_number":15,"context_line":"consumers to successfully build cloud-native applications. Each"},{"line_number":16,"context_line":"comprehensive guide, delivered on developer.openstack.org, will contain a"},{"line_number":17,"context_line":"collection of conceptual articles, reference information, and how-to"},{"line_number":18,"context_line":"articles."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"Problem description"},{"line_number":21,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":8,"id":"7a740942_16e9ce1a","line":18,"in_reply_to":"7a740942_82e25c9e","updated":"2015-12-03 20:56:37.000000000","message":"It is a good question and probably it\u0027s the right time to ask it is now: if I understand David correctly, he\u0027s asking whether we should think of developer.openstack.org as a place where developers find and nurture their knowledge opf openstack apps in a very wide sense, or it\u0027s just a place where they find documentation.\nThe former requires something more sophisticated than static html produced by sphinx.","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"0500d3807a503abe66c4974676ecf673eb7a376e","unresolved":false,"context_lines":[{"line_number":15,"context_line":"consumers to successfully build cloud-native applications. Each"},{"line_number":16,"context_line":"comprehensive guide, delivered on developer.openstack.org, will contain a"},{"line_number":17,"context_line":"collection of conceptual articles, reference information, and how-to"},{"line_number":18,"context_line":"articles."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"Problem description"},{"line_number":21,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":8,"id":"7a740942_82e25c9e","line":18,"in_reply_to":"9a8ffd7b_3f3d57dd","updated":"2015-12-03 19:50:22.000000000","message":"Good questions... I have not yet imagined one of the goals as \"connect app devs\" because there is not such a mechanism already in the greater community. I have viewed it as a resource, listing, reference, not as a connector.\n\nSingle \"blink\" message: \"You too can develop apps on OpenStack. Here\u0027s how.\"","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":14091,"name":"Yih Leong Sun","email":"yihleong@gmail.com","username":"yihleongsun"},"change_message_id":"b3275ae8bd3cd5835042cc04c4a4df915dc5802c","unresolved":false,"context_lines":[{"line_number":57,"context_line":"  * Manage images"},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"* Compute"},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"  * Launch an instance"},{"line_number":62,"context_line":"  * Provide user data to an instance"},{"line_number":63,"context_line":"  * Manage access and security"}],"source_content_type":"text/x-rst","patch_set":8,"id":"9a8ffd7b_f9915d47","line":60,"updated":"2015-12-01 16:35:23.000000000","message":"Is Flavor also included under Compute?","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"0500d3807a503abe66c4974676ecf673eb7a376e","unresolved":false,"context_lines":[{"line_number":57,"context_line":"  * Manage images"},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"* Compute"},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"  * Launch an instance"},{"line_number":62,"context_line":"  * Provide user data to an instance"},{"line_number":63,"context_line":"  * Manage access and security"}],"source_content_type":"text/x-rst","patch_set":8,"id":"7a740942_a268b8bb","line":60,"in_reply_to":"9a8ffd7b_f9915d47","updated":"2015-12-03 19:50:22.000000000","message":"Yes, I\u0027d imagine it\u0027s similar to how this user guide topic is written except it won\u0027t need the dashboard info: http://docs.openstack.org/user-guide/dashboard_launch_instances.html","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":1112,"name":"Everett Toews","email":"everett.toews@rackspace.com","username":"everett-toews"},"change_message_id":"5847041472ad2489856a17099aecd561ba1295ca","unresolved":false,"context_lines":[{"line_number":85,"context_line":"  * Go"},{"line_number":86,"context_line":"  * .Net"},{"line_number":87,"context_line":"  * Java"},{"line_number":88,"context_line":"  * nodejs"},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"* API Complete References"},{"line_number":91,"context_line":"  Based on Swagger, each method should have the following information:"}],"source_content_type":"text/x-rst","patch_set":8,"id":"9a8ffd7b_a6ee4489","line":88,"updated":"2015-12-01 21:44:42.000000000","message":"* Ruby\n* PHP","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":1112,"name":"Everett Toews","email":"everett.toews@rackspace.com","username":"everett-toews"},"change_message_id":"5847041472ad2489856a17099aecd561ba1295ca","unresolved":false,"context_lines":[{"line_number":123,"context_line":"How will consumers find and read these articles? From:"},{"line_number":124,"context_line":""},{"line_number":125,"context_line":" * http://developer.openstack.org"},{"line_number":126,"context_line":" * http://developer.openstack.org/firstapp-libcloud/"},{"line_number":127,"context_line":" * http://developer.openstack.org/api-guide/quick-start/"},{"line_number":128,"context_line":" * http://developer.openstack.org/api-guide/compute/"},{"line_number":129,"context_line":" * http://developer.openstack.org/sdk/ (needs a landing page, currently we use"}],"source_content_type":"text/x-rst","patch_set":8,"id":"9a8ffd7b_e681ac90","line":126,"updated":"2015-12-01 21:44:42.000000000","message":"The URL structure we landed on for the SDKs [1] is something like\n\n    developer.openstack.org/sdks/python/openstacksdk\n\nWould it make sense for the first app to adopt a similar URL structure? e.g.\n\n    developer.openstack.org/firstapp/python/libcloud\n\n[1] https://bugs.launchpad.net/python-openstacksdk/+bug/1479977","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":1112,"name":"Everett Toews","email":"everett.toews@rackspace.com","username":"everett-toews"},"change_message_id":"5847041472ad2489856a17099aecd561ba1295ca","unresolved":false,"context_lines":[{"line_number":126,"context_line":" * http://developer.openstack.org/firstapp-libcloud/"},{"line_number":127,"context_line":" * http://developer.openstack.org/api-guide/quick-start/"},{"line_number":128,"context_line":" * http://developer.openstack.org/api-guide/compute/"},{"line_number":129,"context_line":" * http://developer.openstack.org/sdk/ (needs a landing page, currently we use"},{"line_number":130,"context_line":"   developer.openstack.org/#sdk, an anchor on the landing page)"},{"line_number":131,"context_line":" * http://developer.openstack.org/sdk/python/openstacksdk/"},{"line_number":132,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"9a8ffd7b_66129c64","line":129,"updated":"2015-12-01 21:44:42.000000000","message":"Should be developer.openstack.org/sdks (plural)","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":1112,"name":"Everett Toews","email":"everett.toews@rackspace.com","username":"everett-toews"},"change_message_id":"5847041472ad2489856a17099aecd561ba1295ca","unresolved":false,"context_lines":[{"line_number":128,"context_line":" * http://developer.openstack.org/api-guide/compute/"},{"line_number":129,"context_line":" * http://developer.openstack.org/sdk/ (needs a landing page, currently we use"},{"line_number":130,"context_line":"   developer.openstack.org/#sdk, an anchor on the landing page)"},{"line_number":131,"context_line":" * http://developer.openstack.org/sdk/python/openstacksdk/"},{"line_number":132,"context_line":""},{"line_number":133,"context_line":"and so on as we fill out the outline above with content."},{"line_number":134,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"9a8ffd7b_e6068c1f","line":131,"updated":"2015-12-01 21:44:42.000000000","message":"Should be developer.openstack.org/sdks/python/openstacksdk (plural)","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":1112,"name":"Everett Toews","email":"everett.toews@rackspace.com","username":"everett-toews"},"change_message_id":"5847041472ad2489856a17099aecd561ba1295ca","unresolved":false,"context_lines":[{"line_number":177,"context_line":"* Landing and web pages"},{"line_number":178,"context_line":""},{"line_number":179,"context_line":"  * Revise landing page for developer.openstack.org - russellsim"},{"line_number":180,"context_line":"  * Create landing page for developer.openstack.org/sdk"},{"line_number":181,"context_line":"    - russellsim"},{"line_number":182,"context_line":"  * Create web pages for"},{"line_number":183,"context_line":"    developer.openstack.org/sdk/python/openstacksdk - etowes"}],"source_content_type":"text/x-rst","patch_set":8,"id":"9a8ffd7b_09196179","line":180,"updated":"2015-12-01 21:44:42.000000000","message":"Should be sdks","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":1112,"name":"Everett Toews","email":"everett.toews@rackspace.com","username":"everett-toews"},"change_message_id":"5847041472ad2489856a17099aecd561ba1295ca","unresolved":false,"context_lines":[{"line_number":180,"context_line":"  * Create landing page for developer.openstack.org/sdk"},{"line_number":181,"context_line":"    - russellsim"},{"line_number":182,"context_line":"  * Create web pages for"},{"line_number":183,"context_line":"    developer.openstack.org/sdk/python/openstacksdk - etowes"},{"line_number":184,"context_line":""},{"line_number":185,"context_line":"* Content"},{"line_number":186,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"9a8ffd7b_293b05d3","line":183,"updated":"2015-12-01 21:44:42.000000000","message":"Should be sdks\n\nShould be etoews :)","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":1112,"name":"Everett Toews","email":"everett.toews@rackspace.com","username":"everett-toews"},"change_message_id":"5847041472ad2489856a17099aecd561ba1295ca","unresolved":false,"context_lines":[{"line_number":181,"context_line":"    - russellsim"},{"line_number":182,"context_line":"  * Create web pages for"},{"line_number":183,"context_line":"    developer.openstack.org/sdk/python/openstacksdk - etowes"},{"line_number":184,"context_line":""},{"line_number":185,"context_line":"* Content"},{"line_number":186,"context_line":""},{"line_number":187,"context_line":"  * Complete First App on OpenStack matrix of SDK support (complete)."}],"source_content_type":"text/x-rst","patch_set":8,"id":"9a8ffd7b_49f529c9","line":184,"updated":"2015-12-01 21:44:42.000000000","message":"We probably need another one here\n\n* Remove obsolete content from the SDK landing page. Both the .NET and PHP projects on the current landing page have been removed due to inactivity, see https://wiki.openstack.org/wiki/Stackforge_Namespace_Retirement#Inactive_Projects_to_Retire","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"0500d3807a503abe66c4974676ecf673eb7a376e","unresolved":false,"context_lines":[{"line_number":181,"context_line":"    - russellsim"},{"line_number":182,"context_line":"  * Create web pages for"},{"line_number":183,"context_line":"    developer.openstack.org/sdk/python/openstacksdk - etowes"},{"line_number":184,"context_line":""},{"line_number":185,"context_line":"* Content"},{"line_number":186,"context_line":""},{"line_number":187,"context_line":"  * Complete First App on OpenStack matrix of SDK support (complete)."}],"source_content_type":"text/x-rst","patch_set":8,"id":"7a740942_02466c23","line":184,"in_reply_to":"9a8ffd7b_49f529c9","updated":"2015-12-03 19:50:22.000000000","message":"Those are both done and merged in api-site now, so they no longer appear on the developer.openstack.org landing page. Good catch. I\u0027ll add it here and take credit for doing it already, ha ha ha. :)","commit_id":"7b16857821fcc02fe1fd841930ba3ffd3f7122a3"},{"author":{"_account_id":15409,"name":"Marcela Bonell","email":"marcelabonell@gmail.com","username":"mbonell"},"change_message_id":"80d4ce2587899e2d3bb25e7b62d79c7e8d4797db","unresolved":false,"context_lines":[{"line_number":90,"context_line":"  * Go"},{"line_number":91,"context_line":"  * .Net"},{"line_number":92,"context_line":"  * Java"},{"line_number":93,"context_line":"  * nodejs"},{"line_number":94,"context_line":"  * Ruby"},{"line_number":95,"context_line":"  * PHP"},{"line_number":96,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"7a740942_0756255c","line":93,"updated":"2015-12-06 22:23:51.000000000","message":"Is Node.js","commit_id":"11bdc07a3145f9f1eda34517851c1afbc73c53fa"}]}