)]}'
{"specs/liberty/reorganise-user-guides":[{"author":{"_account_id":10014,"name":"Meg McRoberts","email":"DreidelLhasa@yahoo.com","username":"SstackScribe"},"change_message_id":"7bf64c6046cab6d1801fbd235131a8745f13bf80","unresolved":false,"context_lines":[{"line_number":12,"context_line":""},{"line_number":13,"context_line":"Update the information architecture of the End User Guide and Admin User"},{"line_number":14,"context_line":"Guide to ensure that user and operator content is separated, and the existing"},{"line_number":15,"context_line":"content is accurate and relevant."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"Problem description"},{"line_number":18,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"application/octet-stream","patch_set":1,"id":"bab921fb_986963c1","line":15,"updated":"2015-04-24 06:30:39.000000000","message":"Perhaps we should define these audiences here to ensure that everyone is working from the same definition.  One possibility:\n\n- An operator deploys and manages an OpenStack environment/cloud\n- An administrator deploys and manages tenants/projects on a deployed OpenStack environment/cloud\n- An end user deploys and manages VMs on a deployed tenant/project.\n\nWith this definition, s/operator//administrator in the previous line","commit_id":"16bafabeed6b64540b6d2c3eab30f3cb726611d3"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"1c73b98dec329d2f5b1df5ad918b8f6e749cfaf8","unresolved":false,"context_lines":[{"line_number":12,"context_line":""},{"line_number":13,"context_line":"Update the information architecture of the End User Guide and Admin User"},{"line_number":14,"context_line":"Guide to ensure that user and operator content is separated, and the existing"},{"line_number":15,"context_line":"content is accurate and relevant."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"Problem description"},{"line_number":18,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"application/octet-stream","patch_set":1,"id":"3acd31a7_0672d1e5","line":15,"in_reply_to":"bab921fb_7b8569ab","updated":"2015-04-30 03:47:41.000000000","message":"+1. Added to work items.","commit_id":"16bafabeed6b64540b6d2c3eab30f3cb726611d3"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"1c73b98dec329d2f5b1df5ad918b8f6e749cfaf8","unresolved":false,"context_lines":[{"line_number":12,"context_line":""},{"line_number":13,"context_line":"Update the information architecture of the End User Guide and Admin User"},{"line_number":14,"context_line":"Guide to ensure that user and operator content is separated, and the existing"},{"line_number":15,"context_line":"content is accurate and relevant."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"Problem description"},{"line_number":18,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"application/octet-stream","patch_set":1,"id":"3acd31a7_4668c9f5","line":15,"in_reply_to":"bab921fb_986963c1","updated":"2015-04-30 03:47:41.000000000","message":"I agree that this needs to be defined, but think it\u0027s probably more a work item than something that needs to be defined in the spec. Added to work items.","commit_id":"16bafabeed6b64540b6d2c3eab30f3cb726611d3"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"2fe450477278eca02717a8a4ad69786e3dd31d0f","unresolved":false,"context_lines":[{"line_number":12,"context_line":""},{"line_number":13,"context_line":"Update the information architecture of the End User Guide and Admin User"},{"line_number":14,"context_line":"Guide to ensure that user and operator content is separated, and the existing"},{"line_number":15,"context_line":"content is accurate and relevant."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"Problem description"},{"line_number":18,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"application/octet-stream","patch_set":1,"id":"bab921fb_7b8569ab","line":15,"in_reply_to":"bab921fb_986963c1","updated":"2015-04-30 02:39:02.000000000","message":"To add, developing a user task matrix would identify any overlapping tasks, and provide a clearer picture on reorganising and adding content.","commit_id":"16bafabeed6b64540b6d2c3eab30f3cb726611d3"},{"author":{"_account_id":10014,"name":"Meg McRoberts","email":"DreidelLhasa@yahoo.com","username":"SstackScribe"},"change_message_id":"7bf64c6046cab6d1801fbd235131a8745f13bf80","unresolved":false,"context_lines":[{"line_number":18,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"The current user guides have become disorganised over time, this update"},{"line_number":21,"context_line":"tidies them up."},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Proposed change"},{"line_number":24,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"application/octet-stream","patch_set":1,"id":"bab921fb_984cc343","line":21,"updated":"2015-04-24 06:30:39.000000000","message":"Should we specify that, wherever possible, these guides describe how to do tasks using either Horizon or the command line and manual edits of configuration files?","commit_id":"16bafabeed6b64540b6d2c3eab30f3cb726611d3"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"1c73b98dec329d2f5b1df5ad918b8f6e749cfaf8","unresolved":false,"context_lines":[{"line_number":18,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"The current user guides have become disorganised over time, this update"},{"line_number":21,"context_line":"tidies them up."},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Proposed change"},{"line_number":24,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"application/octet-stream","patch_set":1,"id":"3acd31a7_867ee1ac","line":21,"in_reply_to":"bab921fb_984cc343","updated":"2015-04-30 03:47:41.000000000","message":"Yep, added to work items.","commit_id":"16bafabeed6b64540b6d2c3eab30f3cb726611d3"},{"author":{"_account_id":10014,"name":"Meg McRoberts","email":"DreidelLhasa@yahoo.com","username":"SstackScribe"},"change_message_id":"7bf64c6046cab6d1801fbd235131a8745f13bf80","unresolved":false,"context_lines":[{"line_number":24,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":25,"context_line":""},{"line_number":26,"context_line":"* Identify different types of content in the guides"},{"line_number":27,"context_line":"* Reorganise guides to better present existing content"},{"line_number":28,"context_line":"* Clean up existing content where necessary"},{"line_number":29,"context_line":"* Identify information gaps and raise bugs where necessary"},{"line_number":30,"context_line":""}],"source_content_type":"application/octet-stream","patch_set":1,"id":"bab921fb_78cd6f5c","line":27,"updated":"2015-04-24 06:30:39.000000000","message":"What is the general direction of this organization?  It looks like the current End User Guide has a section about how to do everything in Horizon, then another section about how to do everything from the command line. But the command line sections are often the ones that provide definitions and concepts and some of these would be useful for people who only use the dashboard.  So one possibility would be to have sections structured:\n\nTask-to-be-done\n   General concepts\n   How to do it from the Horizon dashboard\n   How to do it from the command line\n\nIt could also work to use a structure similar to the current one but link between related Horizon and command-line sections.","commit_id":"16bafabeed6b64540b6d2c3eab30f3cb726611d3"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"1c73b98dec329d2f5b1df5ad918b8f6e749cfaf8","unresolved":false,"context_lines":[{"line_number":24,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":25,"context_line":""},{"line_number":26,"context_line":"* Identify different types of content in the guides"},{"line_number":27,"context_line":"* Reorganise guides to better present existing content"},{"line_number":28,"context_line":"* Clean up existing content where necessary"},{"line_number":29,"context_line":"* Identify information gaps and raise bugs where necessary"},{"line_number":30,"context_line":""}],"source_content_type":"application/octet-stream","patch_set":1,"id":"3acd31a7_0649b18b","line":27,"in_reply_to":"bab921fb_78cd6f5c","updated":"2015-04-30 03:47:41.000000000","message":"Added to work items.","commit_id":"16bafabeed6b64540b6d2c3eab30f3cb726611d3"},{"author":{"_account_id":10014,"name":"Meg McRoberts","email":"DreidelLhasa@yahoo.com","username":"SstackScribe"},"change_message_id":"7bf64c6046cab6d1801fbd235131a8745f13bf80","unresolved":false,"context_lines":[{"line_number":25,"context_line":""},{"line_number":26,"context_line":"* Identify different types of content in the guides"},{"line_number":27,"context_line":"* Reorganise guides to better present existing content"},{"line_number":28,"context_line":"* Clean up existing content where necessary"},{"line_number":29,"context_line":"* Identify information gaps and raise bugs where necessary"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"Alternatives"}],"source_content_type":"application/octet-stream","patch_set":1,"id":"bab921fb_f815ff9a","line":28,"updated":"2015-04-24 06:30:39.000000000","message":"Should this be expanded?  Some possibilities:\n\n- Update information for Liberty\n- Add more troubleshooting information and information about which logs relate to each task\n- Be sure that terms are well-defined here (or link to other docs for definitions)","commit_id":"16bafabeed6b64540b6d2c3eab30f3cb726611d3"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"1c73b98dec329d2f5b1df5ad918b8f6e749cfaf8","unresolved":false,"context_lines":[{"line_number":25,"context_line":""},{"line_number":26,"context_line":"* Identify different types of content in the guides"},{"line_number":27,"context_line":"* Reorganise guides to better present existing content"},{"line_number":28,"context_line":"* Clean up existing content where necessary"},{"line_number":29,"context_line":"* Identify information gaps and raise bugs where necessary"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"Alternatives"}],"source_content_type":"application/octet-stream","patch_set":1,"id":"3acd31a7_6631850b","line":28,"in_reply_to":"bab921fb_f815ff9a","updated":"2015-04-30 03:47:41.000000000","message":"I think that adding more content it outside of the scope of this spec, which is specifically about information architecture. The third point you raise, though, is a good idea, and I\u0027ve added it in.","commit_id":"16bafabeed6b64540b6d2c3eab30f3cb726611d3"}],"specs/liberty/reorganise-user-guides.rst":[{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"509605f3ef37559256c638a666191de186c2fd14","unresolved":false,"context_lines":[{"line_number":32,"context_line":""},{"line_number":33,"context_line":"Alternatives"},{"line_number":34,"context_line":"------------"},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"* Leave the guides as they are"},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"Implementation"}],"source_content_type":"text/x-rst","patch_set":12,"id":"3acd31a7_2702e73d","line":35,"updated":"2015-05-05 15:31:13.000000000","message":"I think another alternative to consider is to combine the Admin User Guide with the Cloud Admin Guide -- what do you think?","commit_id":"eef24c2bc6907a30aa5e0f60362de0b0fbb1fcdf"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"509605f3ef37559256c638a666191de186c2fd14","unresolved":false,"context_lines":[{"line_number":52,"context_line":"----------"},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"* Develop a user/task matrix and define a limited set of personas to consume"},{"line_number":55,"context_line":"  the user guide content."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"* Remove the unnecessary/self explanatory procedures from the dashboard"},{"line_number":58,"context_line":"  chapter, for example, \u0027Delete an image\u0027 or \u0027Manage an instance\u0027 and so on."}],"source_content_type":"text/x-rst","patch_set":12,"id":"3acd31a7_e7f74f57","line":55,"updated":"2015-05-05 15:31:13.000000000","message":"I\u0027d like an additional task to de-duplicate with the Cloud Admin Guide.","commit_id":"eef24c2bc6907a30aa5e0f60362de0b0fbb1fcdf"}]}