)]}'
{"specs/newton/osa-install-guide-overhaul.rst":[{"author":{"_account_id":15993,"name":"Amy Marrich","display_name":"Amy Marrich (spotz)","email":"amy@demarco.com","username":"amarrich"},"change_message_id":"c555ac567609399c53f11ced67c39c8e772e0211","unresolved":false,"context_lines":[{"line_number":16,"context_line":"    improving the documentation that pushed the summit discussion."},{"line_number":17,"context_line":"    See here: `https://review.openstack.org/#/c/241037/1`_"},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"    This spec introduces a more formalised plan."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"As it stands, the OpenStack-Ansible install guide has minimal installation"},{"line_number":22,"context_line":"information, and a lot of configuration information."}],"source_content_type":"text/x-rst","patch_set":2,"id":"9abb7d3a_44c9b058","line":19,"range":{"start_line":19,"start_character":32,"end_line":19,"end_character":42},"updated":"2016-05-31 17:53:43.000000000","message":"formalized","commit_id":"c7afb67a9f00347ab376c10c283398ef13370f36"},{"author":{"_account_id":538,"name":"Major Hayden","email":"major@mhtx.net","username":"rackerhacker"},"change_message_id":"fc97df5fd5a1e923ac618f5fe0269a26e8a2b834","unresolved":false,"context_lines":[{"line_number":22,"context_line":"information, and a lot of configuration information."},{"line_number":23,"context_line":"The aim of this spec is to begin the process to separate this information"},{"line_number":24,"context_line":"and streamline the installation guide to make it easier and quicker to"},{"line_number":25,"context_line":"follow for installations."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"See the additional resources below for the etherpad link to the summit"},{"line_number":28,"context_line":"discussion and consensus surrounding this decision."}],"source_content_type":"text/x-rst","patch_set":2,"id":"9abb7d3a_e1fa4442","line":25,"updated":"2016-06-01 02:36:11.000000000","message":"If I remember correctly, we talked about sharing more about an \"opinionated\" installation. Rather than throwing lots of configuration information out there, we ought to make strong recommendations with explanations.\n\nIt\u0027s not a huge thing to add, but I figured it was worth mentioning.","commit_id":"c7afb67a9f00347ab376c10c283398ef13370f36"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"25b6483a7b5d1faad545c8f35e9d852ab1993b19","unresolved":false,"context_lines":[{"line_number":22,"context_line":"information, and a lot of configuration information."},{"line_number":23,"context_line":"The aim of this spec is to begin the process to separate this information"},{"line_number":24,"context_line":"and streamline the installation guide to make it easier and quicker to"},{"line_number":25,"context_line":"follow for installations."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"See the additional resources below for the etherpad link to the summit"},{"line_number":28,"context_line":"discussion and consensus surrounding this decision."}],"source_content_type":"text/x-rst","patch_set":2,"id":"9abb7d3a_5dc203ea","line":25,"in_reply_to":"9abb7d3a_e1fa4442","updated":"2016-06-01 09:47:56.000000000","message":"Hi Major,\n\nSo after some (admittedly, brief) discussions we came up with the idea of making the install guide that of a strict installation guide, rather than that of a smaller installation guide with a large configuration section. \n\nStrong recommendations with explanations (user cases, if I understand correctly), was going to be utilised in the appendices. Unfortunately I have not conveyed that particularly well in this draft (hence, draft). \n\nDoes that answer your questions, or are you more concerned about missing some information discussed at the summit?","commit_id":"c7afb67a9f00347ab376c10c283398ef13370f36"},{"author":{"_account_id":538,"name":"Major Hayden","email":"major@mhtx.net","username":"rackerhacker"},"change_message_id":"fc97df5fd5a1e923ac618f5fe0269a26e8a2b834","unresolved":false,"context_lines":[{"line_number":124,"context_line":"  Alexandra Settle (asettle)"},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Other contributors:"},{"line_number":127,"context_line":"  Darren Chan (darrenc), Jesse Pretorius (odyssey4me), Travis Truman (automagically)"},{"line_number":128,"context_line":""},{"line_number":129,"context_line":""},{"line_number":130,"context_line":"Work items"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9abb7d3a_c1f74057","line":127,"updated":"2016-06-01 02:36:11.000000000","message":"I\u0027m super interested in helping here, too.","commit_id":"c7afb67a9f00347ab376c10c283398ef13370f36"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"25b6483a7b5d1faad545c8f35e9d852ab1993b19","unresolved":false,"context_lines":[{"line_number":124,"context_line":"  Alexandra Settle (asettle)"},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Other contributors:"},{"line_number":127,"context_line":"  Darren Chan (darrenc), Jesse Pretorius (odyssey4me), Travis Truman (automagically)"},{"line_number":128,"context_line":""},{"line_number":129,"context_line":""},{"line_number":130,"context_line":"Work items"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9abb7d3a_fdb3f795","line":127,"in_reply_to":"9abb7d3a_c1f74057","updated":"2016-06-01 09:47:56.000000000","message":"I\u0027ll include you, thanks Major!","commit_id":"c7afb67a9f00347ab376c10c283398ef13370f36"},{"author":{"_account_id":19814,"name":"Travis Truman (automagically)","email":"travis_truman@cable.comcast.com","username":"trumant"},"change_message_id":"e5f32a5aa3a81105fa8f80d5703b90488589767d","unresolved":false,"context_lines":[{"line_number":66,"context_line":"Playbook/Role impact"},{"line_number":67,"context_line":"--------------------"},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"N/A"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":""},{"line_number":72,"context_line":"Upgrade impact"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9abb7d3a_eaaa0284","line":69,"updated":"2016-06-01 12:59:59.000000000","message":"I think we discussed at the design summit that this would have some role impact, primarily in the transition of some documentation that currently exists in the guide, moving from the top-level playbooks project into the role projects documentation.","commit_id":"d28922a01f5efa2f6fcf24199b93d1abace3a2c5"},{"author":{"_account_id":6816,"name":"Jesse Pretorius","email":"jesse@odyssey4.me","username":"jesse-pretorius"},"change_message_id":"e12a488f73b72c04d24e1e322d831dcd5e911a53","unresolved":false,"context_lines":[{"line_number":1,"context_line":"Overhaul of the current OpenStack Ansible Installation Guide"},{"line_number":2,"context_line":"############################################################"},{"line_number":3,"context_line":":date: 2016-05-31 00:00"},{"line_number":4,"context_line":":tags: docs"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9abb7d3a_671c4814","line":1,"range":{"start_line":1,"start_character":24,"end_line":1,"end_character":41},"updated":"2016-06-02 13:09:51.000000000","message":"All references to \u0027OpenStack Ansible\u0027 should be changed to \u0027OpenStack-Ansible\u0027.","commit_id":"3273619fc06ac5f7983dfc1063c3fdedfe0992bd"},{"author":{"_account_id":6816,"name":"Jesse Pretorius","email":"jesse@odyssey4.me","username":"jesse-pretorius"},"change_message_id":"e12a488f73b72c04d24e1e322d831dcd5e911a53","unresolved":false,"context_lines":[{"line_number":43,"context_line":"* Clearly define reference architecture and develop use case configuration"},{"line_number":44,"context_line":"  examples in an appendix."},{"line_number":45,"context_line":"* Removal of the configuration information from the current installation guide"},{"line_number":46,"context_line":"  and including it in the OpenStack-Ansible developer documentation."},{"line_number":47,"context_line":"* Migrate operations content temporarily to OpenStack-Ansible developer documentation"},{"line_number":48,"context_line":"  until an operations guide can be produced."},{"line_number":49,"context_line":"* Restructure the guide to include basic deployment configuration."}],"source_content_type":"text/x-rst","patch_set":7,"id":"9abb7d3a_27ec008f","line":46,"range":{"start_line":46,"start_character":44,"end_line":46,"end_character":67},"updated":"2016-06-02 13:09:51.000000000","message":"Are we talking the developer guide here, or the role documentation? I think the developer guide information does have some overlap with the configuration content, but there is also very specific developer-related content there (eg: contributor guidelines).\n\nI\u0027m torn between us having some sort of \u0027Configuration Reference\u0027 in the integrated repository, and having the configuration reference information in the role repositories. Having them in the role repositories makes it easier to submit patches with configuration guide material - thus keeping the standard of submitting docs, a release note and the patch together.\nHowever, there are some elements of configuration that need to refer across repositories. How do we handle this? Perhaps we should add a developer guideline which makes it clear that cross-repo configuration changes should be \u0027smart\u0027, and thus you should never have to make configuration changes across multiple repositories in an integrated build? eg If you add vpnaas for the neutron role, Horizon automatically gets the panels for it.","commit_id":"3273619fc06ac5f7983dfc1063c3fdedfe0992bd"},{"author":{"_account_id":6816,"name":"Jesse Pretorius","email":"jesse@odyssey4.me","username":"jesse-pretorius"},"change_message_id":"e12a488f73b72c04d24e1e322d831dcd5e911a53","unresolved":false,"context_lines":[{"line_number":44,"context_line":"  examples in an appendix."},{"line_number":45,"context_line":"* Removal of the configuration information from the current installation guide"},{"line_number":46,"context_line":"  and including it in the OpenStack-Ansible developer documentation."},{"line_number":47,"context_line":"* Migrate operations content temporarily to OpenStack-Ansible developer documentation"},{"line_number":48,"context_line":"  until an operations guide can be produced."},{"line_number":49,"context_line":"* Restructure the guide to include basic deployment configuration."},{"line_number":50,"context_line":"* Appendices that include configuration file examples, neutron plugins,"},{"line_number":51,"context_line":"  cinder options and additional resources relevant to an OpenStack-Ansible"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9abb7d3a_67ac4836","line":48,"range":{"start_line":47,"start_character":0,"end_line":48,"end_character":44},"updated":"2016-06-02 13:09:51.000000000","message":"We can perhaps migrate this content to the openstack-ansible-ops repository and simply make reference to it.","commit_id":"3273619fc06ac5f7983dfc1063c3fdedfe0992bd"},{"author":{"_account_id":6816,"name":"Jesse Pretorius","email":"jesse@odyssey4.me","username":"jesse-pretorius"},"change_message_id":"e12a488f73b72c04d24e1e322d831dcd5e911a53","unresolved":false,"context_lines":[{"line_number":58,"context_line":"* Leaving the installation guide as is, and migrating only the configuration"},{"line_number":59,"context_line":"information to the developer docs."},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"* Consider revising the installation guide to meet criteria in `project-specific installation guide"},{"line_number":62,"context_line":"\u003chttp://specs.openstack.org/openstack/docs-specs/specs/newton/project-specific-installguides.html\u003e`_"},{"line_number":63,"context_line":"and publish to docs.openstack.org"},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"Playbook/Role impact"},{"line_number":66,"context_line":"--------------------"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9abb7d3a_8724ccc6","line":63,"range":{"start_line":61,"start_character":0,"end_line":63,"end_character":33},"updated":"2016-06-02 13:09:51.000000000","message":"It would be nice to somehow fit into this and gain the exposure of publishing to docs.openstack.org, but the spec for that work looks fairly incompatible with the work we\u0027re doing. Perhaps we can revisit this next cycle.","commit_id":"3273619fc06ac5f7983dfc1063c3fdedfe0992bd"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"761a45687b87a90c45cbed6c517bf21f6e88de40","unresolved":false,"context_lines":[{"line_number":97,"context_line":"Developer impact"},{"line_number":98,"context_line":"----------------"},{"line_number":99,"context_line":""},{"line_number":100,"context_line":"The only impact that can be noted is that if there is an update to any of"},{"line_number":101,"context_line":"the playbooks that require documentation, the placement for the documents"},{"line_number":102,"context_line":"in question will be moved."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"Dependencies"},{"line_number":105,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9abb7d3a_04873a13","line":102,"range":{"start_line":100,"start_character":0,"end_line":102,"end_character":25},"updated":"2016-06-02 12:41:47.000000000","message":"Does this mean we will need to determine where new documentation will be located and published?","commit_id":"3273619fc06ac5f7983dfc1063c3fdedfe0992bd"},{"author":{"_account_id":6816,"name":"Jesse Pretorius","email":"jesse@odyssey4.me","username":"jesse-pretorius"},"change_message_id":"e12a488f73b72c04d24e1e322d831dcd5e911a53","unresolved":false,"context_lines":[{"line_number":97,"context_line":"Developer impact"},{"line_number":98,"context_line":"----------------"},{"line_number":99,"context_line":""},{"line_number":100,"context_line":"The only impact that can be noted is that if there is an update to any of"},{"line_number":101,"context_line":"the playbooks that require documentation, the placement for the documents"},{"line_number":102,"context_line":"in question will be moved."},{"line_number":103,"context_line":""},{"line_number":104,"context_line":"Dependencies"},{"line_number":105,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9abb7d3a_6a3d2dbb","line":102,"range":{"start_line":100,"start_character":0,"end_line":102,"end_character":25},"in_reply_to":"9abb7d3a_04873a13","updated":"2016-06-02 13:09:51.000000000","message":"To keep the flow of development during this time I think we\u0027ll need to ensure that we move existing content over to the roles first, then developers must submit any new documentation to the role repositories.","commit_id":"3273619fc06ac5f7983dfc1063c3fdedfe0992bd"},{"author":{"_account_id":19814,"name":"Travis Truman (automagically)","email":"travis_truman@cable.comcast.com","username":"trumant"},"change_message_id":"4efad1bcb534fa135481f49cf92de00ec218bd3d","unresolved":false,"context_lines":[{"line_number":14,"context_line":""},{"line_number":15,"context_line":"    A blueprint and spec was previously created with the intention of"},{"line_number":16,"context_line":"    improving the documentation that pushed the summit discussion."},{"line_number":17,"context_line":"    See here: `https://review.openstack.org/#/c/241037/1`_"},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"Currently, the OpenStack-Ansible install guide has minimal installation"},{"line_number":20,"context_line":"information, and a lot of configuration information. This specification proposes"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7aa08908_06a1e094","line":17,"updated":"2016-06-06 13:16:52.000000000","message":"This link is broken in the rendered output for some reason","commit_id":"1bbf150df821bdf9e32e4f79b9afdc17e26a4c8f"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"de528d2bf39e3db1fde39b6469a9ee23330ae4be","unresolved":false,"context_lines":[{"line_number":47,"context_line":"* Migrate operations content temporarily to openstack-ansible-ops repo"},{"line_number":48,"context_line":"  until an operations guide can be produced."},{"line_number":49,"context_line":"* Restructure the guide to include basic deployment configuration."},{"line_number":50,"context_line":"* Appendices that include configuration file examples, neutron plugins,"},{"line_number":51,"context_line":"  cinder options and additional resources relevant to an OpenStack-Ansible"},{"line_number":52,"context_line":"  installation."},{"line_number":53,"context_line":"* Include links to role based documentation from the Installation Guide."},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"Alternatives"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7aa08908_86367001","line":52,"range":{"start_line":50,"start_character":2,"end_line":52,"end_character":15},"updated":"2016-06-06 13:25:33.000000000","message":"This isn\u0027t clear: Should that be part of openstack-ansible documentation, or each appropriate role appropriate documentation?","commit_id":"1bbf150df821bdf9e32e4f79b9afdc17e26a4c8f"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"2a47e6079d170888d1c17f821e3622d11cf4ec35","unresolved":false,"context_lines":[{"line_number":47,"context_line":"* Migrate operations content temporarily to openstack-ansible-ops repo"},{"line_number":48,"context_line":"  until an operations guide can be produced."},{"line_number":49,"context_line":"* Restructure the guide to include basic deployment configuration."},{"line_number":50,"context_line":"* Appendices that include configuration file examples, neutron plugins,"},{"line_number":51,"context_line":"  cinder options and additional resources relevant to an OpenStack-Ansible"},{"line_number":52,"context_line":"  installation."},{"line_number":53,"context_line":"* Include links to role based documentation from the Installation Guide."},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"Alternatives"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7aa08908_45941042","line":52,"range":{"start_line":50,"start_character":2,"end_line":52,"end_character":15},"in_reply_to":"7aa08908_86367001","updated":"2016-06-08 03:00:07.000000000","message":"This spec is defining changes for the install guide.","commit_id":"1bbf150df821bdf9e32e4f79b9afdc17e26a4c8f"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"de528d2bf39e3db1fde39b6469a9ee23330ae4be","unresolved":false,"context_lines":[{"line_number":59,"context_line":"information to the developer docs."},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"* Consider revising the installation guide to meet criteria in `project-specific installation guide"},{"line_number":62,"context_line":"\u003chttp://specs.openstack.org/openstack/docs-specs/specs/newton/project-specific-installguides.html\u003e`_"},{"line_number":63,"context_line":"and publish to docs.openstack.org"},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"Playbook/Role impact"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7aa08908_29978f91","line":62,"range":{"start_line":62,"start_character":1,"end_line":62,"end_character":97},"updated":"2016-06-06 13:25:33.000000000","message":"Could you explain the impact/work on this alternative for non-docs people?","commit_id":"1bbf150df821bdf9e32e4f79b9afdc17e26a4c8f"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"de528d2bf39e3db1fde39b6469a9ee23330ae4be","unresolved":false,"context_lines":[{"line_number":121,"context_line":"Work items"},{"line_number":122,"context_line":"----------"},{"line_number":123,"context_line":""},{"line_number":124,"context_line":"- Clarify and obtain consensus on the content structure"},{"line_number":125,"context_line":"- Gather information from SMEs as needed"},{"line_number":126,"context_line":"- Create a draft directory for installation guide changes"},{"line_number":127,"context_line":"- Create a work items list and allocate resources"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7aa08908_09c29385","line":124,"range":{"start_line":124,"start_character":2,"end_line":124,"end_character":55},"updated":"2016-06-06 13:25:33.000000000","message":"Without going into the commit level description, could you explain how you would do that?","commit_id":"1bbf150df821bdf9e32e4f79b9afdc17e26a4c8f"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"2a47e6079d170888d1c17f821e3622d11cf4ec35","unresolved":false,"context_lines":[{"line_number":121,"context_line":"Work items"},{"line_number":122,"context_line":"----------"},{"line_number":123,"context_line":""},{"line_number":124,"context_line":"- Clarify and obtain consensus on the content structure"},{"line_number":125,"context_line":"- Gather information from SMEs as needed"},{"line_number":126,"context_line":"- Create a draft directory for installation guide changes"},{"line_number":127,"context_line":"- Create a work items list and allocate resources"}],"source_content_type":"text/x-rst","patch_set":11,"id":"7aa08908_e296d2ee","line":124,"range":{"start_line":124,"start_character":2,"end_line":124,"end_character":55},"in_reply_to":"7aa08908_09c29385","updated":"2016-06-08 03:00:07.000000000","message":"Discussion in the OSA weekly meeting, video meet up with technical liasons and docs, iterate content structure in https://docs.google.com/document/d/1WdcA7jIp8w1C52pJu4JmympFe8cOvcxi1I2E19Y6XYE/edit?ts\u003d5743fe3f#heading\u003dh.jg8guj3uzhzw`_ based on community feedback.","commit_id":"1bbf150df821bdf9e32e4f79b9afdc17e26a4c8f"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"de528d2bf39e3db1fde39b6469a9ee23330ae4be","unresolved":false,"context_lines":[{"line_number":124,"context_line":"- Clarify and obtain consensus on the content structure"},{"line_number":125,"context_line":"- Gather information from SMEs as needed"},{"line_number":126,"context_line":"- Create a draft directory for installation guide changes"},{"line_number":127,"context_line":"- Create a work items list and allocate resources"},{"line_number":128,"context_line":"- Ensure documentation meets openstack-manuals writing conventions"},{"line_number":129,"context_line":"- Test draft documentation before publication"},{"line_number":130,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7aa08908_4953fbe1","line":127,"range":{"start_line":127,"start_character":2,"end_line":127,"end_character":49},"updated":"2016-06-06 13:25:33.000000000","message":"Isn\u0027t this the role of the spec?","commit_id":"1bbf150df821bdf9e32e4f79b9afdc17e26a4c8f"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"2a47e6079d170888d1c17f821e3622d11cf4ec35","unresolved":false,"context_lines":[{"line_number":124,"context_line":"- Clarify and obtain consensus on the content structure"},{"line_number":125,"context_line":"- Gather information from SMEs as needed"},{"line_number":126,"context_line":"- Create a draft directory for installation guide changes"},{"line_number":127,"context_line":"- Create a work items list and allocate resources"},{"line_number":128,"context_line":"- Ensure documentation meets openstack-manuals writing conventions"},{"line_number":129,"context_line":"- Test draft documentation before publication"},{"line_number":130,"context_line":""}],"source_content_type":"text/x-rst","patch_set":11,"id":"7aa08908_627942c8","line":127,"range":{"start_line":127,"start_character":2,"end_line":127,"end_character":49},"in_reply_to":"7aa08908_4953fbe1","updated":"2016-06-08 03:00:07.000000000","message":"This would be a more detailed task list/progress tracking page which can include changes at the paragraph and section level.","commit_id":"1bbf150df821bdf9e32e4f79b9afdc17e26a4c8f"}]}