)]}'
{"specs/developer-docs.rst":[{"author":{"_account_id":7353,"name":"Kevin Carter","email":"kevin@cloudnull.com","username":"cloudnull"},"change_message_id":"f1998f3aa8fe24e7079cbd0fa8044f7c1a2347ad","unresolved":false,"context_lines":[{"line_number":1,"context_line":"os-ansible-deployment overview documentation"},{"line_number":2,"context_line":"#################################"},{"line_number":3,"context_line":":date: 2015-04-13 13:00"},{"line_number":4,"context_line":":tags: documentation, docs, developer"},{"line_number":5,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"7aaa499b_384c8b6f","line":2,"updated":"2015-04-14 12:24:21.000000000","message":"The hashes need to go the same length as the header text. Also the file name should be the same as the haeder. something like `os-ansible-deployment-developer-docs.rst`, `os-ansible-deployment-overview-documentation.rst` or similar.","commit_id":"515b571f330c8d372e3cfdb600a898a6161481eb"},{"author":{"_account_id":7353,"name":"Kevin Carter","email":"kevin@cloudnull.com","username":"cloudnull"},"change_message_id":"f1998f3aa8fe24e7079cbd0fa8044f7c1a2347ad","unresolved":false,"context_lines":[{"line_number":44,"context_line":"scripts. It might also document some of the important variables/parameters"},{"line_number":45,"context_line":"for these scripts."},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"* Playbooks should document the high-level playbooks that prepare physical hosts, create containers, and install OpenStack."},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"* Repository role/playbook. Since the repository is fairly unique to"},{"line_number":50,"context_line":"os-ansible-deployment, this should be probably be a bit more detailed than"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7aaa499b_38912b9a","line":47,"updated":"2015-04-14 12:24:21.000000000","message":"nit: line wrap at 79.","commit_id":"515b571f330c8d372e3cfdb600a898a6161481eb"},{"author":{"_account_id":6816,"name":"Jesse Pretorius","email":"jesse@odyssey4.me","username":"jesse-pretorius"},"change_message_id":"c82e0e2bda835bac15ddba4a37a93679fb46b1d2","unresolved":false,"context_lines":[{"line_number":149,"context_line":"Primary assignee:"},{"line_number":150,"context_line":"    nolan-brubaker **palendae**"},{"line_number":151,"context_line":"Other contributors:"},{"line_number":152,"context_line":"  \u003claunchpad-id or None\u003e"},{"line_number":153,"context_line":""},{"line_number":154,"context_line":"Work items"},{"line_number":155,"context_line":"----------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7aaa499b_169ac963","line":152,"updated":"2015-04-14 08:28:28.000000000","message":"I would definitely recommend teaming up with someone on this - perhaps Sam-I-Am if he has the capacity and inclination?","commit_id":"515b571f330c8d372e3cfdb600a898a6161481eb"},{"author":{"_account_id":12892,"name":"Nolan Brubaker","email":"nolan.brubaker@rackspace.com","username":"nrb"},"change_message_id":"3dafc1528a3c95653d92bf24f802ea39bfee0f8d","unresolved":false,"context_lines":[{"line_number":149,"context_line":"Primary assignee:"},{"line_number":150,"context_line":"    nolan-brubaker **palendae**"},{"line_number":151,"context_line":"Other contributors:"},{"line_number":152,"context_line":"  \u003claunchpad-id or None\u003e"},{"line_number":153,"context_line":""},{"line_number":154,"context_line":"Work items"},{"line_number":155,"context_line":"----------"}],"source_content_type":"text/x-rst","patch_set":2,"id":"7aaa499b_155a9f4f","line":152,"in_reply_to":"7aaa499b_169ac963","updated":"2015-04-14 22:39:23.000000000","message":"I agree that more than one person should be involved, though I believe developers should also be keeping the repo documentation up-to-date.\n\nAnyone\u0027s invited to help contribute.","commit_id":"515b571f330c8d372e3cfdb600a898a6161481eb"}],"specs/os-ansible-deployment-overview-documentation.rst":[{"author":{"_account_id":3114,"name":"Karin Levenstein","email":"karin.levenstein@rackspace.com","username":"karin-levenstein"},"change_message_id":"a23cb106c12fd8b728e30cdfbec0a1f6256c3106","unresolved":false,"context_lines":[{"line_number":65,"context_line":"* Individual roles. The individual roles should not be documented as part of"},{"line_number":66,"context_line":"  this. There are too many roles and too many changes to be able to keep up with"},{"line_number":67,"context_line":"  those changes at the os-ansible-deployment level."},{"line_number":68,"context_line":""},{"line_number":69,"context_line":""},{"line_number":70,"context_line":"Alternatives"},{"line_number":71,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ab451fb_ea09d432","line":68,"updated":"2015-04-17 18:09:55.000000000","message":"Might also want to add that end-user docs, such as the install guide, user/admin guide, ops guide, etc are also out of scope.","commit_id":"334e42146358d8bb7bd6c53d2d7e4c87e2547cbf"},{"author":{"_account_id":12892,"name":"Nolan Brubaker","email":"nolan.brubaker@rackspace.com","username":"nrb"},"change_message_id":"29b0dceccc291583ec32ef4ddac24446c78db86c","unresolved":false,"context_lines":[{"line_number":65,"context_line":"* Individual roles. The individual roles should not be documented as part of"},{"line_number":66,"context_line":"  this. There are too many roles and too many changes to be able to keep up with"},{"line_number":67,"context_line":"  those changes at the os-ansible-deployment level."},{"line_number":68,"context_line":""},{"line_number":69,"context_line":""},{"line_number":70,"context_line":"Alternatives"},{"line_number":71,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ab451fb_9d55f81e","line":68,"in_reply_to":"3ab451fb_ea09d432","updated":"2015-04-17 18:36:48.000000000","message":"Done","commit_id":"334e42146358d8bb7bd6c53d2d7e4c87e2547cbf"},{"author":{"_account_id":12807,"name":"Steve Lewis (stevelle)","email":"stevelle@gmail.com","username":"stevelle"},"change_message_id":"42a9f3dea1f14dcdccba578a7a97037d32404a13","unresolved":false,"context_lines":[{"line_number":11,"context_line":""},{"line_number":12,"context_line":"Also, documentation is a constantly shifting thing - this proposal is just"},{"line_number":13,"context_line":"intended to get the initial documents created; documentation maintenance"},{"line_number":14,"context_line":"falls outside of the scope, mostly on the core reviewers."},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"A blueprint for this proposal can be found at:"},{"line_number":17,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"dac4157f_d78fca21","line":14,"updated":"2015-04-21 00:32:41.000000000","message":"not sure this should fall mostly on core reviewers. Developer docs should be by/for contributors. Not sure that the core label makes much difference here either way.","commit_id":"6705c001853b803c392cf23850a6f5cbbd156bbc"},{"author":{"_account_id":12892,"name":"Nolan Brubaker","email":"nolan.brubaker@rackspace.com","username":"nrb"},"change_message_id":"64f99f9cee8f17ce053482c4da33fb1d6787e692","unresolved":false,"context_lines":[{"line_number":11,"context_line":""},{"line_number":12,"context_line":"Also, documentation is a constantly shifting thing - this proposal is just"},{"line_number":13,"context_line":"intended to get the initial documents created; documentation maintenance"},{"line_number":14,"context_line":"falls outside of the scope, mostly on the core reviewers."},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"A blueprint for this proposal can be found at:"},{"line_number":17,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"dac4157f_8c5a6082","line":14,"in_reply_to":"dac4157f_d78fca21","updated":"2015-04-21 00:50:46.000000000","message":"That\u0027s true; my intention here is for core contributors to help make sure that changes do not merge without docs updates. I will update the wording to just say \u0027reviewers\u0027","commit_id":"6705c001853b803c392cf23850a6f5cbbd156bbc"},{"author":{"_account_id":12807,"name":"Steve Lewis (stevelle)","email":"stevelle@gmail.com","username":"stevelle"},"change_message_id":"42a9f3dea1f14dcdccba578a7a97037d32404a13","unresolved":false,"context_lines":[{"line_number":34,"context_line":"This proposal recommends making a new docs repo, which would contain Sphinx"},{"line_number":35,"context_line":"documentation on the following documentation:"},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"* Brief history of the project"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"* Overview of doing deployments using os-ansible-deployment"},{"line_number":40,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"dac4157f_17c5423b","line":37,"updated":"2015-04-21 00:32:41.000000000","message":"what value is added by history? that might clarify the content included in this item.","commit_id":"6705c001853b803c392cf23850a6f5cbbd156bbc"},{"author":{"_account_id":12892,"name":"Nolan Brubaker","email":"nolan.brubaker@rackspace.com","username":"nrb"},"change_message_id":"64f99f9cee8f17ce053482c4da33fb1d6787e692","unresolved":false,"context_lines":[{"line_number":34,"context_line":"This proposal recommends making a new docs repo, which would contain Sphinx"},{"line_number":35,"context_line":"documentation on the following documentation:"},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"* Brief history of the project"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"* Overview of doing deployments using os-ansible-deployment"},{"line_number":40,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"dac4157f_6c5f0c73","line":37,"in_reply_to":"dac4157f_17c5423b","updated":"2015-04-21 00:50:46.000000000","message":"My intention would be to explain the rpc technical debt releases, mostly.","commit_id":"6705c001853b803c392cf23850a6f5cbbd156bbc"},{"author":{"_account_id":7217,"name":"Hugh Saunders","email":"hugh@wherenow.org","username":"hughsaunders"},"change_message_id":"034b7adc629e87366fdade99b92aa50deca0698e","unresolved":false,"context_lines":[{"line_number":52,"context_line":"  openstack_other.yml files are of particular interest here."},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"* Inventory management. This section should discuss the dynamic_inventory.py"},{"line_number":55,"context_line":"  file and and the inventory_management.py files."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"Also, the docs directory should be built by Sphinx on a regular basis,"},{"line_number":58,"context_line":"preferably at the gate."}],"source_content_type":"text/x-rst","patch_set":4,"id":"bab921fb_8e93414f","line":55,"updated":"2015-04-24 14:44:00.000000000","message":"Most of this seems relevant to end users. With the possible exception of scripts, but run-playbooks could be useful.  Maybe a non-rpc branch of the end user docs would cover quite a lot of this?","commit_id":"6705c001853b803c392cf23850a6f5cbbd156bbc"},{"author":{"_account_id":12892,"name":"Nolan Brubaker","email":"nolan.brubaker@rackspace.com","username":"nrb"},"change_message_id":"6d99c8d2711659b5a9d980266224551882f1c791","unresolved":false,"context_lines":[{"line_number":52,"context_line":"  openstack_other.yml files are of particular interest here."},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"* Inventory management. This section should discuss the dynamic_inventory.py"},{"line_number":55,"context_line":"  file and and the inventory_management.py files."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"Also, the docs directory should be built by Sphinx on a regular basis,"},{"line_number":58,"context_line":"preferably at the gate."}],"source_content_type":"text/x-rst","patch_set":4,"id":"5ad0253b_b543606c","line":55,"in_reply_to":"bab921fb_8e93414f","updated":"2015-04-28 16:03:02.000000000","message":"There is certainly overlap. I know there is discussion of having separate end user documentation created that might provide a different perspective.\n\nIf they end up merging later, I think that\u0027s fine, though I\u0027d rather start getting something written down and not wait for that.","commit_id":"6705c001853b803c392cf23850a6f5cbbd156bbc"},{"author":{"_account_id":7414,"name":"David Wilde","email":"dwilde@redhat.com","username":"d34dh0r53"},"change_message_id":"840b66f2d9de62ae8308c2099af0a18926cd2644","unresolved":false,"context_lines":[{"line_number":43,"context_line":"  scripts. It might also document some of the important variables/parameters"},{"line_number":44,"context_line":"  for these scripts."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"* Playbooks should document the high-level playbooks that prepare physical hosts, create containers, and install OpenStack."},{"line_number":47,"context_line":""},{"line_number":48,"context_line":"* Repository role/playbook. Since the repository is fairly unique to"},{"line_number":49,"context_line":"  os-ansible-deployment, this should be probably be a bit more detailed than"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3acd31a7_4a17bced","line":46,"updated":"2015-04-30 14:48:18.000000000","message":"This line needs a wrap","commit_id":"0cacd9aa72cb57b2f1275d0619f0030986df28b8"}]}