)]}'
{"specs/kilo/move-driver-docs.rst":[{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"48f27adb6d596ed947c4b13c7b9ba1573146302f","unresolved":false,"context_lines":[{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Many of these drivers are hardware or software specific and can only"},{"line_number":28,"context_line":"be documented by the third-party driver vendor. Many vendors lack with"},{"line_number":29,"context_line":"documenting these at all, or do not keep these updated. Since most"},{"line_number":30,"context_line":"vendors have already on their web page documentation about the"},{"line_number":31,"context_line":"drivers, this spec proposes to move the documentation completely to"},{"line_number":32,"context_line":"the vendor web pages and just link to them. This will reduce work for"}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_c5b65edc","line":29,"updated":"2014-11-11 03:24:30.000000000","message":"Source for \"Many vendors lack with documenting these at all, or do not keep these updated.\" ?\n\nMy memory is sketchy, but so far I\u0027ve witnessed pretty good updates from those that have things in tree. There are certainly more than a few that are not documented, though.","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"48f27adb6d596ed947c4b13c7b9ba1573146302f","unresolved":false,"context_lines":[{"line_number":31,"context_line":"drivers, this spec proposes to move the documentation completely to"},{"line_number":32,"context_line":"the vendor web pages and just link to them. This will reduce work for"},{"line_number":33,"context_line":"both documentation team and vendor drivers."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"Proposed change"},{"line_number":36,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":37,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_45f8ae7c","line":34,"updated":"2014-11-11 03:24:30.000000000","message":"I actually think this last sentence \"This will reduce work for both documentation team and vendor drivers.\" is the real problem description. If possible, I would like to see this spec updated with this fleshed out a little, just so we can be sure that this line is true, and the work is justifiable. We don\u0027t want to go to this effort if the effort to change takes more effort than the effort to keep status quo! :D","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":10058,"name":"Erlon R. Cruz","email":"erlon.rodrigues.cruz@canonical.com","username":"sombrafam"},"change_message_id":"e4ccbae03cbdb43c5ca0dc76f6ec887d9618e098","unresolved":false,"context_lines":[{"line_number":31,"context_line":"drivers, this spec proposes to move the documentation completely to"},{"line_number":32,"context_line":"the vendor web pages and just link to them. This will reduce work for"},{"line_number":33,"context_line":"both documentation team and vendor drivers."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"Proposed change"},{"line_number":36,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":37,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_895f080e","line":34,"in_reply_to":"5a890539_45f8ae7c","updated":"2014-11-11 16:37:28.000000000","message":"I don\u0027t see a problem if there\u0027s an bigger effort to improve the status, since this effort is only done one time. In the status quo, we will have to spend effort forever.","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"8dddc074b3e18d588f40d329a8ee931b6c1579ee","unresolved":false,"context_lines":[{"line_number":31,"context_line":"drivers, this spec proposes to move the documentation completely to"},{"line_number":32,"context_line":"the vendor web pages and just link to them. This will reduce work for"},{"line_number":33,"context_line":"both documentation team and vendor drivers."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"Proposed change"},{"line_number":36,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":37,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_ae4be157","line":34,"in_reply_to":"5a890539_895f080e","updated":"2014-11-11 16:48:33.000000000","message":"Oh, of course - I\u0027m not opposing anything here! Just suggesting that there could be more text along the lines.","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"48f27adb6d596ed947c4b13c7b9ba1573146302f","unresolved":false,"context_lines":[{"line_number":42,"context_line":"documentation:"},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"* The driver must be fully open source"},{"line_number":45,"context_line":"* The driver must be part of the respective OpenStack repository"},{"line_number":46,"context_line":"* The driver is considered one of the default drivers"},{"line_number":47,"context_line":""},{"line_number":48,"context_line":"For documentation of other drivers, the following guidelines apply:"}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_2504827a","line":45,"updated":"2014-11-11 03:24:30.000000000","message":"being part of the repository is a must - agreed!","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":10058,"name":"Erlon R. Cruz","email":"erlon.rodrigues.cruz@canonical.com","username":"sombrafam"},"change_message_id":"e4ccbae03cbdb43c5ca0dc76f6ec887d9618e098","unresolved":false,"context_lines":[{"line_number":43,"context_line":""},{"line_number":44,"context_line":"* The driver must be fully open source"},{"line_number":45,"context_line":"* The driver must be part of the respective OpenStack repository"},{"line_number":46,"context_line":"* The driver is considered one of the default drivers"},{"line_number":47,"context_line":""},{"line_number":48,"context_line":"For documentation of other drivers, the following guidelines apply:"},{"line_number":49,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_29961495","line":46,"updated":"2014-11-11 16:37:28.000000000","message":"I think \u0027reference driver\u0027 is a better word than default.","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"48f27adb6d596ed947c4b13c7b9ba1573146302f","unresolved":false,"context_lines":[{"line_number":43,"context_line":""},{"line_number":44,"context_line":"* The driver must be fully open source"},{"line_number":45,"context_line":"* The driver must be part of the respective OpenStack repository"},{"line_number":46,"context_line":"* The driver is considered one of the default drivers"},{"line_number":47,"context_line":""},{"line_number":48,"context_line":"For documentation of other drivers, the following guidelines apply:"},{"line_number":49,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_65c76a46","line":46,"updated":"2014-11-11 03:24:30.000000000","message":"I\u0027m wary of the statement regarding \"default\" drivers, and would prefer a more pragmatic approach. Sometimes the default isn\u0027t the best - especially in the case where it\u0027s new/has changed from last release . . .","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"48f27adb6d596ed947c4b13c7b9ba1573146302f","unresolved":false,"context_lines":[{"line_number":48,"context_line":"For documentation of other drivers, the following guidelines apply:"},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* The Configuration Reference will contain only a single link to an"},{"line_number":51,"context_line":"  external document"},{"line_number":52,"context_line":"* Only drivers are linked that are contained in the official OpenStack"},{"line_number":53,"context_line":"  project repository for drivers (for example in the main project"},{"line_number":54,"context_line":"  repository or the official \"third party\" repository)."}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_25b642da","line":51,"updated":"2014-11-11 03:24:30.000000000","message":"Alternative implementation idea:\n\nSee http://docs.openstack.org/trunk/config-reference/content/sheepdog-driver.html \u003c-- I think something like this which has the one quick reference line that you need, along with the link could be useful.\n\nAnother example (I know it\u0027s open source, but for example\u0027s sake) is http://docs.openstack.org/trunk/config-reference/content/smbfs-volume-driver.html  \u003c-- Imagine there\u0027s also a link in there to the vendor docs, and with quick reference line (which almost never changes), table of options automatically generated from code means no maintenance cost.\n\nI think something like those could provide more value than just a bare link, and it really isn\u0027t a lot of effort at all to keep stuff like that.","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":7264,"name":"Summer Long","email":"slong@redhat.com","username":"slong"},"change_message_id":"e56559c9c9a1275fa167fb7f7c35c42eb29df91a","unresolved":false,"context_lines":[{"line_number":48,"context_line":"For documentation of other drivers, the following guidelines apply:"},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* The Configuration Reference will contain only a single link to an"},{"line_number":51,"context_line":"  external document"},{"line_number":52,"context_line":"* Only drivers are linked that are contained in the official OpenStack"},{"line_number":53,"context_line":"  project repository for drivers (for example in the main project"},{"line_number":54,"context_line":"  repository or the official \"third party\" repository)."}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_72ad5731","line":51,"in_reply_to":"5a890539_25b642da","updated":"2014-11-11 23:39:13.000000000","message":"Agree","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"48f27adb6d596ed947c4b13c7b9ba1573146302f","unresolved":false,"context_lines":[{"line_number":57,"context_line":"following:"},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"* For cinder: volume drivers: document LVM only; backup drivers:"},{"line_number":60,"context_line":"  Document swift and ceph (TBD)"},{"line_number":61,"context_line":"* For glance: Document local storage and using cinder as backend"},{"line_number":62,"context_line":"* For neutron: document ML2 plug-in with the mechanisms drivers"},{"line_number":63,"context_line":"  OpenVSwitch and LinuxBridge"}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_c5dd7e16","line":60,"updated":"2014-11-11 03:24:30.000000000","message":"what about samba and glusterfs? (I\u0027ve no preference - they just seemed to meet the criteria above)","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":7264,"name":"Summer Long","email":"slong@redhat.com","username":"slong"},"change_message_id":"e56559c9c9a1275fa167fb7f7c35c42eb29df91a","unresolved":false,"context_lines":[{"line_number":57,"context_line":"following:"},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"* For cinder: volume drivers: document LVM only; backup drivers:"},{"line_number":60,"context_line":"  Document swift and ceph (TBD)"},{"line_number":61,"context_line":"* For glance: Document local storage and using cinder as backend"},{"line_number":62,"context_line":"* For neutron: document ML2 plug-in with the mechanisms drivers"},{"line_number":63,"context_line":"  OpenVSwitch and LinuxBridge"}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_b2a7bf4e","line":60,"in_reply_to":"5a890539_c5dd7e16","updated":"2014-11-11 23:39:13.000000000","message":"Agree","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"48f27adb6d596ed947c4b13c7b9ba1573146302f","unresolved":false,"context_lines":[{"line_number":58,"context_line":""},{"line_number":59,"context_line":"* For cinder: volume drivers: document LVM only; backup drivers:"},{"line_number":60,"context_line":"  Document swift and ceph (TBD)"},{"line_number":61,"context_line":"* For glance: Document local storage and using cinder as backend"},{"line_number":62,"context_line":"* For neutron: document ML2 plug-in with the mechanisms drivers"},{"line_number":63,"context_line":"  OpenVSwitch and LinuxBridge"},{"line_number":64,"context_line":"* For nova: document KVM (mostly), send Xen open source call for help"}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_e5e27ad4","line":61,"updated":"2014-11-11 03:24:30.000000000","message":"what about swift? Very common deployment mode.","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":7923,"name":"Gauvain Pocentek","email":"gauvainpocentek@gmail.com","username":"gpocentek"},"change_message_id":"bd47fbb276c796a64c322731699dbab8c63ecef7","unresolved":false,"context_lines":[{"line_number":58,"context_line":""},{"line_number":59,"context_line":"* For cinder: volume drivers: document LVM only; backup drivers:"},{"line_number":60,"context_line":"  Document swift and ceph (TBD)"},{"line_number":61,"context_line":"* For glance: Document local storage and using cinder as backend"},{"line_number":62,"context_line":"* For neutron: document ML2 plug-in with the mechanisms drivers"},{"line_number":63,"context_line":"  OpenVSwitch and LinuxBridge"},{"line_number":64,"context_line":"* For nova: document KVM (mostly), send Xen open source call for help"}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_8b51b264","line":61,"in_reply_to":"5a890539_e5e27ad4","updated":"2014-11-11 19:25:37.000000000","message":"I agree with Tom here. Plus it\u0027s part of OpenStack \"core\", so we should document it.","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":3185,"name":"Alessandro Pilotti","email":"apilotti@cloudbasesolutions.com","username":"alexpilotti"},"change_message_id":"73969a65f5c9324588da357feec0275d2304a576","unresolved":false,"context_lines":[{"line_number":61,"context_line":"* For glance: Document local storage and using cinder as backend"},{"line_number":62,"context_line":"* For neutron: document ML2 plug-in with the mechanisms drivers"},{"line_number":63,"context_line":"  OpenVSwitch and LinuxBridge"},{"line_number":64,"context_line":"* For nova: document KVM (mostly), send Xen open source call for help"},{"line_number":65,"context_line":"* For sahara: apache hadoop"},{"line_number":66,"context_line":"* For trove: mysql/mariadb"},{"line_number":67,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_c449128d","line":64,"updated":"2014-11-10 12:57:18.000000000","message":"I find this point arguable. For example all Nova supported hypervisors are supposed to be equal. By adding documentation only for KVM and Xen, other drivers won\u0027t have the same level or visibility in the community limiting their growth and adoption potential. \n\nI totally understand and agree on the need to reduce the burden and get the drivers documentations out of tree, but this should apply to ALL drivers in order to provide the same experience and opportunities.","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"ff06809160d3646bc3df0f4854b0f264dfd0d6fa","unresolved":false,"context_lines":[{"line_number":61,"context_line":"* For glance: Document local storage and using cinder as backend"},{"line_number":62,"context_line":"* For neutron: document ML2 plug-in with the mechanisms drivers"},{"line_number":63,"context_line":"  OpenVSwitch and LinuxBridge"},{"line_number":64,"context_line":"* For nova: document KVM (mostly), send Xen open source call for help"},{"line_number":65,"context_line":"* For sahara: apache hadoop"},{"line_number":66,"context_line":"* For trove: mysql/mariadb"},{"line_number":67,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_ef36e7e6","line":64,"in_reply_to":"5a890539_c449128d","updated":"2014-11-10 13:01:51.000000000","message":"This is a consequence of the guidelines from lines 43-45 above.","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":3185,"name":"Alessandro Pilotti","email":"apilotti@cloudbasesolutions.com","username":"alexpilotti"},"change_message_id":"b48d1b97957d65a606c1dbd72427f37a34c920bb","unresolved":false,"context_lines":[{"line_number":61,"context_line":"* For glance: Document local storage and using cinder as backend"},{"line_number":62,"context_line":"* For neutron: document ML2 plug-in with the mechanisms drivers"},{"line_number":63,"context_line":"  OpenVSwitch and LinuxBridge"},{"line_number":64,"context_line":"* For nova: document KVM (mostly), send Xen open source call for help"},{"line_number":65,"context_line":"* For sahara: apache hadoop"},{"line_number":66,"context_line":"* For trove: mysql/mariadb"},{"line_number":67,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_2fee2fed","line":64,"in_reply_to":"5a890539_ef36e7e6","updated":"2014-11-10 13:13:36.000000000","message":"Just as an example, the Hyper-V and VMWare drivers are matching all 3 points on lines 43-45. unless you mean that the underlying hypervisor technology (Hyper-V or VMWare) should be open source as well and in that case line 43 should be definitely changed to reflect that.","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"48f27adb6d596ed947c4b13c7b9ba1573146302f","unresolved":false,"context_lines":[{"line_number":63,"context_line":"  OpenVSwitch and LinuxBridge"},{"line_number":64,"context_line":"* For nova: document KVM (mostly), send Xen open source call for help"},{"line_number":65,"context_line":"* For sahara: apache hadoop"},{"line_number":66,"context_line":"* For trove: mysql/mariadb"},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"TBD: Double check above list for completeness."},{"line_number":69,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_25ed62c4","line":66,"updated":"2014-11-11 03:24:30.000000000","message":"Trove\u0027s value could be seen as being able to run multiple database types easily. Basically all of its options are open source, and there is no real \u0027default\u0027 - looks like a change might be needed to the strategy here.","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"48f27adb6d596ed947c4b13c7b9ba1573146302f","unresolved":false,"context_lines":[{"line_number":68,"context_line":"TBD: Double check above list for completeness."},{"line_number":69,"context_line":""},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"TBD: We need to decide on the documentation of the configuration options!"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"Alternatives"},{"line_number":74,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_c5049e80","line":71,"updated":"2014-11-11 03:24:30.000000000","message":"it takes pretty minimal effort to run the auto-conf script - don\u0027t you think?","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":7923,"name":"Gauvain Pocentek","email":"gauvainpocentek@gmail.com","username":"gpocentek"},"change_message_id":"bd47fbb276c796a64c322731699dbab8c63ecef7","unresolved":false,"context_lines":[{"line_number":68,"context_line":"TBD: Double check above list for completeness."},{"line_number":69,"context_line":""},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"TBD: We need to decide on the documentation of the configuration options!"},{"line_number":72,"context_line":""},{"line_number":73,"context_line":"Alternatives"},{"line_number":74,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_cbf9fa4e","line":71,"in_reply_to":"5a890539_c5049e80","updated":"2014-11-11 19:25:37.000000000","message":"Yes, generating the tables is relatively easy, so we could (should?) provide them.","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"48f27adb6d596ed947c4b13c7b9ba1573146302f","unresolved":false,"context_lines":[{"line_number":90,"context_line":"Work Items"},{"line_number":91,"context_line":"----------"},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"* Inform third party driver contacts about change"},{"line_number":94,"context_line":"* Remove all files"},{"line_number":95,"context_line":"* Add back links for external websites"},{"line_number":96,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_e5099a96","line":93,"updated":"2014-11-11 03:24:30.000000000","message":"I think the conversation should be started with the current contributors well prior to the change (in fact -sending them to this spec), but I also recall Andreas may have already started this :)","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"58eb63115c55e62554f8881dfdc8c4361faab155","unresolved":false,"context_lines":[{"line_number":90,"context_line":"Work Items"},{"line_number":91,"context_line":"----------"},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"* Inform third party driver contacts about change"},{"line_number":94,"context_line":"* Remove all files"},{"line_number":95,"context_line":"* Add back links for external websites"},{"line_number":96,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_e62b6080","line":93,"in_reply_to":"5a890539_e5099a96","updated":"2014-11-11 08:06:14.000000000","message":"I started some of this already and now went through git log to reach out to more, this needs indeed some more discussion and places to ask for comments are welcome. I\u0027ll send something to the 3rd party lists later as well.","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":10058,"name":"Erlon R. Cruz","email":"erlon.rodrigues.cruz@canonical.com","username":"sombrafam"},"change_message_id":"e4ccbae03cbdb43c5ca0dc76f6ec887d9618e098","unresolved":false,"context_lines":[{"line_number":92,"context_line":""},{"line_number":93,"context_line":"* Inform third party driver contacts about change"},{"line_number":94,"context_line":"* Remove all files"},{"line_number":95,"context_line":"* Add back links for external websites"},{"line_number":96,"context_line":""},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"Dependencies"}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a890539_29f9b4c8","line":95,"updated":"2014-11-11 16:37:28.000000000","message":"How do you plan to get the links from the vendors? We update the manual?","commit_id":"f8ff679aa6dd786792a172aa9241aa9e74361754"},{"author":{"_account_id":3185,"name":"Alessandro Pilotti","email":"apilotti@cloudbasesolutions.com","username":"alexpilotti"},"change_message_id":"3647cad524c5af9a4a4dab6782651292ecc4ca06","unresolved":false,"context_lines":[{"line_number":50,"context_line":"Guidelines for drivers that will be documented fully in the OpenStack"},{"line_number":51,"context_line":"documentation:"},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"* The driver itself must be fully open source"},{"line_number":54,"context_line":"* The complete solution must be open source or standard hardware"},{"line_number":55,"context_line":"* The driver must be part of the respective OpenStack repository"},{"line_number":56,"context_line":"* The driver is considered one of the reference drivers"}],"source_content_type":"text/x-rst","patch_set":7,"id":"5a890539_e3585f34","line":53,"updated":"2014-11-13 15:13:14.000000000","message":"IMO this line is redundant. To be documented, a driver must be part of one of the projects listed above (Nova, Neutron, etc) and as such it has anyway to be licensed as Apache 2.","commit_id":"d9f3c5f21f18c9c02a3b13756705ae806fe54dea"},{"author":{"_account_id":3185,"name":"Alessandro Pilotti","email":"apilotti@cloudbasesolutions.com","username":"alexpilotti"},"change_message_id":"3647cad524c5af9a4a4dab6782651292ecc4ca06","unresolved":false,"context_lines":[{"line_number":51,"context_line":"documentation:"},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"* The driver itself must be fully open source"},{"line_number":54,"context_line":"* The complete solution must be open source or standard hardware"},{"line_number":55,"context_line":"* The driver must be part of the respective OpenStack repository"},{"line_number":56,"context_line":"* The driver is considered one of the reference drivers"},{"line_number":57,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"5a890539_0049e18a","line":54,"updated":"2014-11-13 15:13:14.000000000","message":"Can you please define what \"or standard hardware\" means?\nDid you mean \"on standard hardware\"?","commit_id":"d9f3c5f21f18c9c02a3b13756705ae806fe54dea"},{"author":{"_account_id":3185,"name":"Alessandro Pilotti","email":"apilotti@cloudbasesolutions.com","username":"alexpilotti"},"change_message_id":"3647cad524c5af9a4a4dab6782651292ecc4ca06","unresolved":false,"context_lines":[{"line_number":74,"context_line":"  OpenVSwitch and LinuxBridge"},{"line_number":75,"context_line":"* For nova: document KVM (mostly), send Xen open source call for help"},{"line_number":76,"context_line":"* For sahara: apache hadoop"},{"line_number":77,"context_line":"* For trove: document all supported Open Source database like MySQL."},{"line_number":78,"context_line":""},{"line_number":79,"context_line":"TBD: Double check above list for completeness."},{"line_number":80,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"5a890539_802b1193","line":77,"updated":"2014-11-13 15:13:14.000000000","message":"nit, typo: databases. Database engines would be better IMHO","commit_id":"d9f3c5f21f18c9c02a3b13756705ae806fe54dea"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"5b68c6937a66298bb95d58b3565411058b74800d","unresolved":false,"context_lines":[{"line_number":10,"context_line":""},{"line_number":11,"context_line":"https://blueprints.launchpad.net/openstack-manuals/+spec/move-driver-docs"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"The goal of this spec is to get consistent and version independend"},{"line_number":14,"context_line":"driver documentation. It will give driver writers more flexibility in"},{"line_number":15,"context_line":"changing the documentation while reducing work for both documentation"},{"line_number":16,"context_line":"team and driver authors."}],"source_content_type":"text/x-rst","patch_set":8,"id":"5a890539_c1bf52fb","line":13,"updated":"2014-11-18 18:39:44.000000000","message":"independent\n\nMake sure you clarify who\u0027s version you want to be independent of, the driver or OpenStack?\n\nPerhaps revise as:\n\nShared goals for driver documentation include:\n- consistent documentation, comparable for each driver.\n- version-independent documentation for each driver, meaning the OpenStack version can change but the driver documentation can remain the same.\n- maintainable documentation for each driver that won\u0027t change much over time and remains accurate.\n- reviewable documentation for each driver.\n\nSome benefits we see for this new approach are:\n- more flexibility in changing detailed driver documentation on the appropriate website.\n- makes maintenance of detailed driver doc easier for contributing driver writers since they can choose their source and publishing chain that fits with their current workflow.\n- reduces maintenance for core OpenStack documentation team.","commit_id":"c8b6fa40e27490c756d6fcb4b09c8571ddc469ae"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"5b68c6937a66298bb95d58b3565411058b74800d","unresolved":false,"context_lines":[{"line_number":17,"context_line":""},{"line_number":18,"context_line":"The driver documention for most drivers will be changed so that the"},{"line_number":19,"context_line":"OpenStack manuals contains brief version independent information and a"},{"line_number":20,"context_line":"link to a vendor page with full details."},{"line_number":21,"context_line":""},{"line_number":22,"context_line":"Problem description"},{"line_number":23,"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":"5a890539_01515ad8","line":20,"updated":"2014-11-18 18:39:44.000000000","message":"Let\u0027s be more detailed that \"most\" drivers even in this overview. How about:\n\nThe driver documentation for compute, storage, networking, and databases will change as described so that the...","commit_id":"c8b6fa40e27490c756d6fcb4b09c8571ddc469ae"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"5b68c6937a66298bb95d58b3565411058b74800d","unresolved":false,"context_lines":[{"line_number":37,"context_line":"great in-tree documentation and update it regularly, others have none"},{"line_number":38,"context_line":"or only outdated documentation. Since most vendors have already on"},{"line_number":39,"context_line":"their web page documentation about the drivers, this spec proposes to"},{"line_number":40,"context_line":"move the documentation to the vendor web pages and just link to them."},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"This will reduce work for both documentation team and vendor drivers."},{"line_number":43,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"5a890539_416282ae","line":40,"updated":"2014-11-18 18:39:44.000000000","message":"perhaps \"simply\" instead of \"just\"","commit_id":"c8b6fa40e27490c756d6fcb4b09c8571ddc469ae"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"5b68c6937a66298bb95d58b3565411058b74800d","unresolved":false,"context_lines":[{"line_number":67,"context_line":""},{"line_number":68,"context_line":"* For cinder: volume drivers: document LVM only (TBD: Samba,"},{"line_number":69,"context_line":"  glusterfs); backup drivers:"},{"line_number":70,"context_line":"  Document swift and ceph (TBD)"},{"line_number":71,"context_line":"* For glance: Document local storage, cinder, and swift as backends"},{"line_number":72,"context_line":"* For neutron: document ML2 plug-in with the mechanisms drivers"},{"line_number":73,"context_line":"  OpenVSwitch and LinuxBridge"}],"source_content_type":"text/x-rst","patch_set":8,"id":"5a890539_210496c5","line":70,"updated":"2014-11-18 18:39:44.000000000","message":"I\u0027d start with Document swift and not sign up for ceph ongoing maintenance, what do others think?","commit_id":"c8b6fa40e27490c756d6fcb4b09c8571ddc469ae"},{"author":{"_account_id":612,"name":"Tom Fifield","email":"tom@openstack.org","username":"fifieldt"},"change_message_id":"2e6b678a4e1b19cf5c28b2c440593528418972d4","unresolved":false,"context_lines":[{"line_number":67,"context_line":""},{"line_number":68,"context_line":"* For cinder: volume drivers: document LVM only (TBD: Samba,"},{"line_number":69,"context_line":"  glusterfs); backup drivers:"},{"line_number":70,"context_line":"  Document swift and ceph (TBD)"},{"line_number":71,"context_line":"* For glance: Document local storage, cinder, and swift as backends"},{"line_number":72,"context_line":"* For neutron: document ML2 plug-in with the mechanisms drivers"},{"line_number":73,"context_line":"  OpenVSwitch and LinuxBridge"}],"source_content_type":"text/x-rst","patch_set":8,"id":"5a890539_aa720dab","line":70,"in_reply_to":"5a890539_210496c5","updated":"2014-11-19 04:07:35.000000000","message":"Right! Ceph should only ever be documented as a block storage driver. The line here implies it is an OpenStack Object Storage option, which it is not.\n\nIf you look at ceph doc at the moment (http://docs.openstack.org/trunk/config-reference/content/ceph-rados.html) ... it\u0027s kinda already in the \"vendor\" format proposed","commit_id":"c8b6fa40e27490c756d6fcb4b09c8571ddc469ae"},{"author":{"_account_id":287,"name":"Stefano Maffulli \u0027reed\u0027","email":"stefano@openstack.org","username":"smaffulli"},"change_message_id":"8c851c67f3cbd73d5e41e5a348be33719073db50","unresolved":false,"context_lines":[{"line_number":34,"context_line":"Databases will change as described so that the OpenStack manuals"},{"line_number":35,"context_line":"contains brief version independent information and a link to a vendor"},{"line_number":36,"context_line":"page with full details."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"Problem description"},{"line_number":39,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":40,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"3a961159_72f68c5e","line":37,"updated":"2014-12-14 22:09:48.000000000","message":"I think part of this spec has to be assure discoverability of such vendor pages. I think it\u0027s fair to assume that as a user of OpenStack, I would like to be able to go to docs.openstack.org, search for \u0027vendor name\u0027 and find documentation, regardless of who maintains those pages.","commit_id":"8c358e32473d5e234869e17e2e13d524d93ac6a4"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"365dd0cefac977bba21cc9877fdee937f8b65aed","unresolved":false,"context_lines":[{"line_number":34,"context_line":"Databases will change as described so that the OpenStack manuals"},{"line_number":35,"context_line":"contains brief version independent information and a link to a vendor"},{"line_number":36,"context_line":"page with full details."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"Problem description"},{"line_number":39,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":40,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"3a961159_723bbe9c","line":37,"in_reply_to":"3a961159_72f68c5e","updated":"2014-12-16 07:14:11.000000000","message":"Stefano, I think your concern is addressed with line 96 and following. We still want to have a list of the various drivers together with the automatically generated options and a link to the external page.","commit_id":"8c358e32473d5e234869e17e2e13d524d93ac6a4"},{"author":{"_account_id":13523,"name":"Vadivel Poonathan","email":"vadivel.openstack@gmail.com","username":"vpoonathan"},"change_message_id":"05cfb3fb5fa1d9c7e7b4a97c77ccaf609a87edeb","unresolved":false,"context_lines":[{"line_number":76,"context_line":"  driver, see below for details"},{"line_number":77,"context_line":"* Only drivers are covered that are contained in the official"},{"line_number":78,"context_line":"  OpenStack project repository for drivers (for example in the main"},{"line_number":79,"context_line":"  project repository or the official \"third party\" repository)."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"With this policy, the docs team will document in their guides the"},{"line_number":82,"context_line":"following:"}],"source_content_type":"text/x-rst","patch_set":10,"id":"3a961159_2df626d8","line":79,"updated":"2014-12-08 20:05:27.000000000","message":"I understand the \"other drivers\" mean the external drivers which are not part of the official openstack repository. So the reference drivers which are part of the official openstack repository will be \"fully\" documented and for the other such external drivers, this new idea of listing them with a short description and a link to vendor provided webpage is proposed!.\n\nSo why again it is mentioned as \"\"Only drivers are covered that are contained in the official OpenStack project repository\"\" ???? - i \u0027m confused!.\n\nIf this new proposal (short desc and external link) is again meant for only the drivers that are part of official openstack main repository - then why do we need this proposal itself?... \n\nI believe it originally triggered from the fact that we need a placeholder for listing the out-of-tree drivers. Since they are not part of the official openstack release/repository, they can not be documented or listed in the current existing documentation. Hence this idea of providing a placeholder with short desc and external link is proposed. Hence the out-of-tree vendors will maintain their plugin/drivers and detailed documentation. \n\nPls. let me know if i missing something.","commit_id":"8c358e32473d5e234869e17e2e13d524d93ac6a4"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"743f28b3b7c6db9534a6af738d37b0dbbbd0cfe2","unresolved":false,"context_lines":[{"line_number":76,"context_line":"  driver, see below for details"},{"line_number":77,"context_line":"* Only drivers are covered that are contained in the official"},{"line_number":78,"context_line":"  OpenStack project repository for drivers (for example in the main"},{"line_number":79,"context_line":"  project repository or the official \"third party\" repository)."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"With this policy, the docs team will document in their guides the"},{"line_number":82,"context_line":"following:"}],"source_content_type":"text/x-rst","patch_set":10,"id":"3a961159_4b799a2e","line":79,"in_reply_to":"3a961159_2df626d8","updated":"2014-12-08 21:11:30.000000000","message":"This conversation was more influenced by the workload strain on the docs team and the accuracy difficulty we have in reviewing (nevermind testing) incoming doc patches related to a driver.\n\nI still believe that a wiki page can serve the purpose of a listing of non-tested-by-OpenStack-non-repository-contained drivers. Perhaps the revision for clarity would be:\n\nThe docs.openstack.org site will only list drivers that are:\n- stored in the official OpenStack repository for drivers, whether it\u0027s the main repo or third-party repo\n- tested by the official OpenStack continuous integration system\nFor any other possible drivers that do not fit these criteria, a list can be made available on a wiki page on wiki.openstack.org similar to the one maintained for hypervisors at https://wiki.openstack.org/wiki/HypervisorSupportMatrix.","commit_id":"8c358e32473d5e234869e17e2e13d524d93ac6a4"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"e32befd5c81efb8bab6a33749f1415e9a4c914e8","unresolved":false,"context_lines":[{"line_number":76,"context_line":"  driver, see below for details"},{"line_number":77,"context_line":"* Only drivers are covered that are contained in the official"},{"line_number":78,"context_line":"  OpenStack project repository for drivers (for example in the main"},{"line_number":79,"context_line":"  project repository or the official \"third party\" repository)."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"With this policy, the docs team will document in their guides the"},{"line_number":82,"context_line":"following:"}],"source_content_type":"text/x-rst","patch_set":10,"id":"3a961159_738c7236","line":79,"in_reply_to":"3a961159_3683ca05","updated":"2014-12-09 13:33:00.000000000","message":"Yes. We should point to that spec here so they\u0027re cross-referenced.","commit_id":"8c358e32473d5e234869e17e2e13d524d93ac6a4"},{"author":{"_account_id":13523,"name":"Vadivel Poonathan","email":"vadivel.openstack@gmail.com","username":"vpoonathan"},"change_message_id":"7b47121ab4b8f1dfff908d2c160a01ab390bb536","unresolved":false,"context_lines":[{"line_number":76,"context_line":"  driver, see below for details"},{"line_number":77,"context_line":"* Only drivers are covered that are contained in the official"},{"line_number":78,"context_line":"  OpenStack project repository for drivers (for example in the main"},{"line_number":79,"context_line":"  project repository or the official \"third party\" repository)."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"With this policy, the docs team will document in their guides the"},{"line_number":82,"context_line":"following:"}],"source_content_type":"text/x-rst","patch_set":10,"id":"3a961159_3683ca05","line":79,"in_reply_to":"3a961159_4b799a2e","updated":"2014-12-09 02:01:42.000000000","message":"So you mean the \"third-party\" repository is the new repository which is created for out-of-tree drivers ?... (related to another proposal under review for moving neutron vendor plugins/driver out-of-tree) ???","commit_id":"8c358e32473d5e234869e17e2e13d524d93ac6a4"},{"author":{"_account_id":13461,"name":"Mudassir Latif","email":"mudassir.latif@purestorage.com","username":"Mudassir.Latif"},"change_message_id":"819ed5a1a8028cd2f1fa4b9cf3faf90d2b4e84b5","unresolved":false,"context_lines":[{"line_number":97,"context_line":""},{"line_number":98,"context_line":""},{"line_number":99,"context_line":"For each external driver, we want to document briefly the driver in a"},{"line_number":100,"context_line":"way that is version independend and include the current configuration"},{"line_number":101,"context_line":"options."},{"line_number":102,"context_line":""},{"line_number":103,"context_line":"Each section should follow this format:"}],"source_content_type":"text/x-rst","patch_set":10,"id":"5a890539_2c6eefc9","line":100,"updated":"2014-12-01 18:46:28.000000000","message":"typo - independend vs independent","commit_id":"8c358e32473d5e234869e17e2e13d524d93ac6a4"},{"author":{"_account_id":13059,"name":"Kedar Vidvans","email":"kedar.vidvans@oracle.com","username":"kedar-vidvans"},"change_message_id":"ed6515772f684b2970d1b7ea6e3cf5c61860942a","unresolved":false,"context_lines":[{"line_number":82,"context_line":"following:"},{"line_number":83,"context_line":""},{"line_number":84,"context_line":"* For cinder: volume drivers: document LVM only (TBD later: Samba,"},{"line_number":85,"context_line":"  glusterfs); backup drivers: document swift (TBD later: ceph)"},{"line_number":86,"context_line":"* For glance: Document local storage, cinder, and swift as backends"},{"line_number":87,"context_line":"* For neutron: document ML2 plug-in with the mechanisms drivers"},{"line_number":88,"context_line":"  OpenVSwitch and LinuxBridge"}],"source_content_type":"text/x-rst","patch_set":12,"id":"da86d52c_779a3763","line":85,"updated":"2015-02-18 16:11:44.000000000","message":"Generic NFS? http://docs.openstack.org/juno/config-reference/content/NFS-driver.html","commit_id":"67f80bee3ec79d83d330f21a75505bedd928c4a9"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"b54fe510799d843ca87542a1ab1e715ef744de1b","unresolved":false,"context_lines":[{"line_number":82,"context_line":"following:"},{"line_number":83,"context_line":""},{"line_number":84,"context_line":"* For cinder: volume drivers: document LVM only (TBD later: Samba,"},{"line_number":85,"context_line":"  glusterfs); backup drivers: document swift (TBD later: ceph)"},{"line_number":86,"context_line":"* For glance: Document local storage, cinder, and swift as backends"},{"line_number":87,"context_line":"* For neutron: document ML2 plug-in with the mechanisms drivers"},{"line_number":88,"context_line":"  OpenVSwitch and LinuxBridge"}],"source_content_type":"text/x-rst","patch_set":12,"id":"da86d52c_a67e3ae2","line":85,"in_reply_to":"da86d52c_779a3763","updated":"2015-02-18 17:58:47.000000000","message":"Indeed, we should document generic NFS.","commit_id":"67f80bee3ec79d83d330f21a75505bedd928c4a9"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"ee79dafc45ef621db97e2ef291da91e5b00972df","unresolved":false,"context_lines":[{"line_number":82,"context_line":"following:"},{"line_number":83,"context_line":""},{"line_number":84,"context_line":"* For cinder: volume drivers: document LVM only (TBD later: Samba,"},{"line_number":85,"context_line":"  glusterfs); backup drivers: document swift (TBD later: ceph)"},{"line_number":86,"context_line":"* For glance: Document local storage, cinder, and swift as backends"},{"line_number":87,"context_line":"* For neutron: document ML2 plug-in with the mechanisms drivers"},{"line_number":88,"context_line":"  OpenVSwitch and LinuxBridge"}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba7be1f8_bf3c3230","line":85,"in_reply_to":"da86d52c_a67e3ae2","updated":"2015-02-26 18:27:45.000000000","message":"Done","commit_id":"67f80bee3ec79d83d330f21a75505bedd928c4a9"},{"author":{"_account_id":13059,"name":"Kedar Vidvans","email":"kedar.vidvans@oracle.com","username":"kedar-vidvans"},"change_message_id":"ed6515772f684b2970d1b7ea6e3cf5c61860942a","unresolved":false,"context_lines":[{"line_number":103,"context_line":"Each section should follow this format:"},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"* A short paragraph explaining the driver."},{"line_number":106,"context_line":"* A link with detailed instructions to the vendor site"},{"line_number":107,"context_line":"* A default paragraph like::"},{"line_number":108,"context_line":""},{"line_number":109,"context_line":"    Set the following in your cinder.conf, and use the following options"}],"source_content_type":"text/x-rst","patch_set":12,"id":"da86d52c_57fa9377","line":106,"updated":"2015-02-18 16:11:44.000000000","message":"Any plan for vendors that do not have OpenStack driver related documentation on their webpage? Such vendors would generally point all their users to docs.openstack.org","commit_id":"67f80bee3ec79d83d330f21a75505bedd928c4a9"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"ee79dafc45ef621db97e2ef291da91e5b00972df","unresolved":false,"context_lines":[{"line_number":103,"context_line":"Each section should follow this format:"},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"* A short paragraph explaining the driver."},{"line_number":106,"context_line":"* A link with detailed instructions to the vendor site"},{"line_number":107,"context_line":"* A default paragraph like::"},{"line_number":108,"context_line":""},{"line_number":109,"context_line":"    Set the following in your cinder.conf, and use the following options"}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba7be1f8_7f0e3a8d","line":106,"in_reply_to":"ba7be1f8_9a058ec4","updated":"2015-02-26 18:27:45.000000000","message":"I\u0027m reworking the spec, please review the new change, it should address your concerns.","commit_id":"67f80bee3ec79d83d330f21a75505bedd928c4a9"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"b54fe510799d843ca87542a1ab1e715ef744de1b","unresolved":false,"context_lines":[{"line_number":103,"context_line":"Each section should follow this format:"},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"* A short paragraph explaining the driver."},{"line_number":106,"context_line":"* A link with detailed instructions to the vendor site"},{"line_number":107,"context_line":"* A default paragraph like::"},{"line_number":108,"context_line":""},{"line_number":109,"context_line":"    Set the following in your cinder.conf, and use the following options"}],"source_content_type":"text/x-rst","patch_set":12,"id":"da86d52c_c656ce5d","line":106,"in_reply_to":"da86d52c_57fa9377","updated":"2015-02-18 17:58:47.000000000","message":"Those would thus only get minimal documentation.","commit_id":"67f80bee3ec79d83d330f21a75505bedd928c4a9"},{"author":{"_account_id":13059,"name":"Kedar Vidvans","email":"kedar.vidvans@oracle.com","username":"kedar-vidvans"},"change_message_id":"7feb7c34d39ab66fea77f23399fbc52f2c2157bb","unresolved":false,"context_lines":[{"line_number":103,"context_line":"Each section should follow this format:"},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"* A short paragraph explaining the driver."},{"line_number":106,"context_line":"* A link with detailed instructions to the vendor site"},{"line_number":107,"context_line":"* A default paragraph like::"},{"line_number":108,"context_line":""},{"line_number":109,"context_line":"    Set the following in your cinder.conf, and use the following options"}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba7be1f8_9a058ec4","line":106,"in_reply_to":"da86d52c_c656ce5d","updated":"2015-02-20 21:14:48.000000000","message":"Please define minimal. \nAlso, IMO, vendors that have documentation can be encouraged to just provide a link to it in docs.openstack.org, but it should not be compulsory since it would be disadvantageous to those vendors that do not have openstack documentation on their public web page.","commit_id":"67f80bee3ec79d83d330f21a75505bedd928c4a9"},{"author":{"_account_id":7160,"name":"arkady kanevsky","email":"akanevsk@redhat.com","username":"arkady"},"change_message_id":"0f52f53e86be5620fada4b47392cb1671494c8bd","unresolved":false,"context_lines":[{"line_number":131,"context_line":"   to the standard mentioned."},{"line_number":132,"context_line":"#. Work with third party drivers to convert existing documentation to"},{"line_number":133,"context_line":"   new standard."},{"line_number":134,"context_line":""},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"Assignee(s)"},{"line_number":137,"context_line":"-----------"}],"source_content_type":"text/x-rst","patch_set":12,"id":"1a930d6b_d4cc89bd","line":134,"updated":"2015-01-27 18:25:39.000000000","message":"Like the idea. but feels that we need to address a few more things.\n1, It feels that we need to ensure that all documentation still need to be in public space. Using sourceforge repo per vendor driver per project is naive starting point. Somewhat similar to neutron handling of drivers.\n2. We need to ensure that formats for all driver documentation is consistent. I like the plan of default driver format will be used for all drivers. But I feel that we need to beef-up CI to ensure it.\n3. Feels that we need to tag or version documentation. per release version. By default the latest version of driver can be used for current release, It is best for a driver owner add tag for each release it should be used for. But I not even sure that will work as I expect that new functionality added that default driver will cause new section added to documentation.\n4. Which brings the final comment on what rules do we want to set in effect  for documentation or driver that had not been updated? I expect that the rules we are using for drivers that are not under CI are applied. But we need to spell it out in the spec.","commit_id":"67f80bee3ec79d83d330f21a75505bedd928c4a9"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"331702a6996e4e5ce25dbed6969f07d426d91a1f","unresolved":false,"context_lines":[{"line_number":131,"context_line":"   to the standard mentioned."},{"line_number":132,"context_line":"#. Work with third party drivers to convert existing documentation to"},{"line_number":133,"context_line":"   new standard."},{"line_number":134,"context_line":""},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"Assignee(s)"},{"line_number":137,"context_line":"-----------"}],"source_content_type":"text/x-rst","patch_set":12,"id":"da86d52c_1e5e78e9","line":134,"in_reply_to":"1a930d6b_d4cc89bd","updated":"2015-02-18 15:08:10.000000000","message":"Arkaday, I\u0027m not sure you understood the spec, please reread.\n\nAd 1: We\u0027re not forcing driver vendors for any place at all, they can use that place and tools that fits them best. Many vendors already have such documentation, so this spec avoids duplication.\n\nAd 2. This is something we will do in openstack-manuals only. If you have ideas on how to CI it, that\u0027s great - but CI is not a blocker for this, the review team can handle it just fine.\n\nAd 3: The config reference is versioned, and if you want different links to your driver for different versions, that\u0027s perfectly fine.\n\nAd 4: We\u0027re not enforcing anything today, and won\u0027t do it in the future.","commit_id":"67f80bee3ec79d83d330f21a75505bedd928c4a9"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"ee79dafc45ef621db97e2ef291da91e5b00972df","unresolved":false,"context_lines":[{"line_number":131,"context_line":"   to the standard mentioned."},{"line_number":132,"context_line":"#. Work with third party drivers to convert existing documentation to"},{"line_number":133,"context_line":"   new standard."},{"line_number":134,"context_line":""},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"Assignee(s)"},{"line_number":137,"context_line":"-----------"}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba7be1f8_9f6f6e2a","line":134,"in_reply_to":"ba7be1f8_ffa4bc58","updated":"2015-02-26 18:27:45.000000000","message":"Please review the next iteration which aims to address your comments.","commit_id":"67f80bee3ec79d83d330f21a75505bedd928c4a9"},{"author":{"_account_id":7160,"name":"arkady kanevsky","email":"akanevsk@redhat.com","username":"arkady"},"change_message_id":"3e55e7a2e22e29ab677630f174d5d5572649dcea","unresolved":false,"context_lines":[{"line_number":131,"context_line":"   to the standard mentioned."},{"line_number":132,"context_line":"#. Work with third party drivers to convert existing documentation to"},{"line_number":133,"context_line":"   new standard."},{"line_number":134,"context_line":""},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"Assignee(s)"},{"line_number":137,"context_line":"-----------"}],"source_content_type":"text/x-rst","patch_set":12,"id":"ba7be1f8_ffa4bc58","line":134,"in_reply_to":"da86d52c_1e5e78e9","updated":"2015-02-20 21:02:40.000000000","message":"Ad 1: Yes and no. Yes most vendors have their own documentation. But in many cases one need to have login info to have access to it, or you need to register and various other speed bumps.\nIt would be nice for OpenStack open source documentation to have common set of rule that people expect from open source documentation.\n\nThe rest is OK.","commit_id":"67f80bee3ec79d83d330f21a75505bedd928c4a9"},{"author":{"_account_id":9186,"name":"Bob Callaway","email":"bcallawa@redhat.com","username":"rcallawa"},"change_message_id":"c972f8ddec21375bb88abc82ad39ca67588563e1","unresolved":false,"context_lines":[{"line_number":4,"context_line":""},{"line_number":5,"context_line":" http://creativecommons.org/licenses/by/3.0/legalcode"},{"line_number":6,"context_line":""},{"line_number":7,"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\u003d0\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":8,"context_line":"Proprietary driver docs in openstack-manuals"},{"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"},{"line_number":10,"context_line":""}],"source_content_type":"text/x-rst","patch_set":17,"id":"ba7be1f8_ae2a1c7c","line":7,"updated":"2015-02-27 14:28:08.000000000","message":"minor typo here","commit_id":"9c0352fa99d8cc2ec49a3262702f103d5d2718d8"},{"author":{"_account_id":9186,"name":"Bob Callaway","email":"bcallawa@redhat.com","username":"rcallawa"},"change_message_id":"c972f8ddec21375bb88abc82ad39ca67588563e1","unresolved":false,"context_lines":[{"line_number":115,"context_line":"-------------------------------------------"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"For each external driver, we want to document briefly the driver in a"},{"line_number":118,"context_line":"way that is version independend and include the current configuration"},{"line_number":119,"context_line":"options."},{"line_number":120,"context_line":""},{"line_number":121,"context_line":"Each section should follow this format:"}],"source_content_type":"text/x-rst","patch_set":17,"id":"ba7be1f8_ce7bd079","line":118,"updated":"2015-02-27 14:28:08.000000000","message":"s/independed/independent","commit_id":"9c0352fa99d8cc2ec49a3262702f103d5d2718d8"},{"author":{"_account_id":13059,"name":"Kedar Vidvans","email":"kedar.vidvans@oracle.com","username":"kedar-vidvans"},"change_message_id":"5ebfd9fff3d1fc545835917ff21f99829bd799f7","unresolved":false,"context_lines":[{"line_number":35,"context_line":""},{"line_number":36,"context_line":"The driver documentation for Compute, Storage, Networking, and"},{"line_number":37,"context_line":"Databases will change as described with the goal of having accurate"},{"line_number":38,"context_line":"documentation. This can be brief version independend information in"},{"line_number":39,"context_line":"the OpenStack manuals with a link to a vendor page with full details"},{"line_number":40,"context_line":"or full version."},{"line_number":41,"context_line":""}],"source_content_type":"text/x-rst","patch_set":18,"id":"ba7be1f8_613035e9","line":38,"updated":"2015-02-27 14:40:58.000000000","message":"while you are at it, independent is miss-spelled. wont hold this up. Change only if you need to submit another revision.","commit_id":"68fc6c5eb435ca058561d420192651d80be2c765"},{"author":{"_account_id":7160,"name":"arkady kanevsky","email":"akanevsk@redhat.com","username":"arkady"},"change_message_id":"2e46f5a2a7db2f7b1d5c9801bca9fed301602e4b","unresolved":false,"context_lines":[{"line_number":78,"context_line":"Guidelines for drivers that will be documented fully by the OpenStack"},{"line_number":79,"context_line":"community in the OpenStack documentation:"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"* The complete solution must be open source and use standard hardware"},{"line_number":82,"context_line":"* The driver must be part of the respective OpenStack repository"},{"line_number":83,"context_line":"* The driver is considered one of the reference drivers"},{"line_number":84,"context_line":""}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_d53dbb90","line":81,"updated":"2015-03-03 00:29:56.000000000","message":"Do we care what is the licensing for open source?\nAll OpenStack is Apache 2 license.\nAll Linux open source are under GPL2 or 3 for kernel driver, and LGPL for user space drivers.","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":7160,"name":"arkady kanevsky","email":"akanevsk@redhat.com","username":"arkady"},"change_message_id":"ad5a609ba0552ca9963ef623dfc14ff5b7aaaa2f","unresolved":false,"context_lines":[{"line_number":78,"context_line":"Guidelines for drivers that will be documented fully by the OpenStack"},{"line_number":79,"context_line":"community in the OpenStack documentation:"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"* The complete solution must be open source and use standard hardware"},{"line_number":82,"context_line":"* The driver must be part of the respective OpenStack repository"},{"line_number":83,"context_line":"* The driver is considered one of the reference drivers"},{"line_number":84,"context_line":""}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_5a5c6f19","line":81,"in_reply_to":"ba7be1f8_040c7cec","updated":"2015-03-03 18:05:57.000000000","message":"Ok with it.\nAs long documentation for 3rd party driver is freely available.\nWhich is the root cause of later comment.","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"ecb521c6af21bacc7ef6bee33810e84a420fda3d","unresolved":false,"context_lines":[{"line_number":78,"context_line":"Guidelines for drivers that will be documented fully by the OpenStack"},{"line_number":79,"context_line":"community in the OpenStack documentation:"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"* The complete solution must be open source and use standard hardware"},{"line_number":82,"context_line":"* The driver must be part of the respective OpenStack repository"},{"line_number":83,"context_line":"* The driver is considered one of the reference drivers"},{"line_number":84,"context_line":""}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_040c7cec","line":81,"in_reply_to":"ba7be1f8_d53dbb90","updated":"2015-03-03 07:25:39.000000000","message":"The OpenStack Documentation team itself will document only Open Source solutions and not vendor solutions.","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":7160,"name":"arkady kanevsky","email":"akanevsk@redhat.com","username":"arkady"},"change_message_id":"2e46f5a2a7db2f7b1d5c9801bca9fed301602e4b","unresolved":false,"context_lines":[{"line_number":108,"context_line":"* For nova: document KVM (mostly), send Xen open source call for help"},{"line_number":109,"context_line":"* For sahara: apache hadoop"},{"line_number":110,"context_line":"* For trove: document all supported Open Source database engines like"},{"line_number":111,"context_line":"  MySQL."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":""},{"line_number":114,"context_line":"Default section format for external drivers"}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_d50bfbd3","line":111,"updated":"2015-03-03 00:29:56.000000000","message":"Need to be specific here as for all other projects.\nAll - is too wage.\nMy SQL and Postgres comes to mind.","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":7160,"name":"arkady kanevsky","email":"akanevsk@redhat.com","username":"arkady"},"change_message_id":"ad5a609ba0552ca9963ef623dfc14ff5b7aaaa2f","unresolved":false,"context_lines":[{"line_number":108,"context_line":"* For nova: document KVM (mostly), send Xen open source call for help"},{"line_number":109,"context_line":"* For sahara: apache hadoop"},{"line_number":110,"context_line":"* For trove: document all supported Open Source database engines like"},{"line_number":111,"context_line":"  MySQL."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":""},{"line_number":114,"context_line":"Default section format for external drivers"}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_1a94b789","line":111,"in_reply_to":"ba7be1f8_64fa98be","updated":"2015-03-03 18:05:57.000000000","message":"My mistake.\nWrongly interpreted it as DB under all OpenStack components.\nIf it is for Trove I am fine.","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"ecb521c6af21bacc7ef6bee33810e84a420fda3d","unresolved":false,"context_lines":[{"line_number":108,"context_line":"* For nova: document KVM (mostly), send Xen open source call for help"},{"line_number":109,"context_line":"* For sahara: apache hadoop"},{"line_number":110,"context_line":"* For trove: document all supported Open Source database engines like"},{"line_number":111,"context_line":"  MySQL."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":""},{"line_number":114,"context_line":"Default section format for external drivers"}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_64fa98be","line":111,"in_reply_to":"ba7be1f8_d50bfbd3","updated":"2015-03-03 07:25:39.000000000","message":"We will evolve this over time. And this is not vague, we just refer to what trove supports.","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":7160,"name":"arkady kanevsky","email":"akanevsk@redhat.com","username":"arkady"},"change_message_id":"2e46f5a2a7db2f7b1d5c9801bca9fed301602e4b","unresolved":false,"context_lines":[{"line_number":129,"context_line":""},{"line_number":130,"context_line":"    volume_driver \u003d cinder.volume.drivers.smbfs.SmbfsDriver"},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"* And finally the autogenerated configuration options"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"Driver vendors can send in patches for these or create bugs."},{"line_number":135,"context_line":""}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_15291337","line":132,"updated":"2015-03-03 00:29:56.000000000","message":"auto-generated. Not sure what that means in this context.","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"ecb521c6af21bacc7ef6bee33810e84a420fda3d","unresolved":false,"context_lines":[{"line_number":129,"context_line":""},{"line_number":130,"context_line":"    volume_driver \u003d cinder.volume.drivers.smbfs.SmbfsDriver"},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"* And finally the autogenerated configuration options"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"Driver vendors can send in patches for these or create bugs."},{"line_number":135,"context_line":""}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_6421b84c","line":132,"in_reply_to":"ba7be1f8_15291337","updated":"2015-03-03 07:25:39.000000000","message":"Read the config reference manual and have a look at the table.","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":7160,"name":"arkady kanevsky","email":"akanevsk@redhat.com","username":"arkady"},"change_message_id":"ad5a609ba0552ca9963ef623dfc14ff5b7aaaa2f","unresolved":false,"context_lines":[{"line_number":129,"context_line":""},{"line_number":130,"context_line":"    volume_driver \u003d cinder.volume.drivers.smbfs.SmbfsDriver"},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"* And finally the autogenerated configuration options"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"Driver vendors can send in patches for these or create bugs."},{"line_number":135,"context_line":""}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_5a70ef3f","line":132,"in_reply_to":"ba7be1f8_6421b84c","updated":"2015-03-03 18:05:57.000000000","message":"good with that.","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":7160,"name":"arkady kanevsky","email":"akanevsk@redhat.com","username":"arkady"},"change_message_id":"2e46f5a2a7db2f7b1d5c9801bca9fed301602e4b","unresolved":false,"context_lines":[{"line_number":131,"context_line":""},{"line_number":132,"context_line":"* And finally the autogenerated configuration options"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"Driver vendors can send in patches for these or create bugs."},{"line_number":135,"context_line":""},{"line_number":136,"context_line":""},{"line_number":137,"context_line":"Full documentation by vendors"}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_d8d6d24e","line":134,"updated":"2015-03-03 00:29:56.000000000","message":"Is there CI support for these patches?\nor these just human reviews?\nnot clear if one need to create a bug to make a change to driver documentation.","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":7160,"name":"arkady kanevsky","email":"akanevsk@redhat.com","username":"arkady"},"change_message_id":"ad5a609ba0552ca9963ef623dfc14ff5b7aaaa2f","unresolved":false,"context_lines":[{"line_number":131,"context_line":""},{"line_number":132,"context_line":"* And finally the autogenerated configuration options"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"Driver vendors can send in patches for these or create bugs."},{"line_number":135,"context_line":""},{"line_number":136,"context_line":""},{"line_number":137,"context_line":"Full documentation by vendors"}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_c0415064","line":134,"in_reply_to":"ba7be1f8_64e8d8e2","updated":"2015-03-03 18:05:57.000000000","message":"good","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"ecb521c6af21bacc7ef6bee33810e84a420fda3d","unresolved":false,"context_lines":[{"line_number":131,"context_line":""},{"line_number":132,"context_line":"* And finally the autogenerated configuration options"},{"line_number":133,"context_line":""},{"line_number":134,"context_line":"Driver vendors can send in patches for these or create bugs."},{"line_number":135,"context_line":""},{"line_number":136,"context_line":""},{"line_number":137,"context_line":"Full documentation by vendors"}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_64e8d8e2","line":134,"in_reply_to":"ba7be1f8_d8d6d24e","updated":"2015-03-03 07:25:39.000000000","message":"See https://wiki.openstack.org/wiki/Documentation and also read about DocImpact.","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":7160,"name":"arkady kanevsky","email":"akanevsk@redhat.com","username":"arkady"},"change_message_id":"2e46f5a2a7db2f7b1d5c9801bca9fed301602e4b","unresolved":false,"context_lines":[{"line_number":150,"context_line":"full documentation to a minimal version."},{"line_number":151,"context_line":""},{"line_number":152,"context_line":"The documentation team will review vendor drivers and ensure that the"},{"line_number":153,"context_line":"various driver documents follow a consistent standard."},{"line_number":154,"context_line":""},{"line_number":155,"context_line":"Alternatives"},{"line_number":156,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_581e620d","line":153,"updated":"2015-03-03 00:29:56.000000000","message":"Need clarity if all 3rd party driver can maintain the current documentation in openstack or must create one on their company web page and have a pointer to it form minimal version, or either (their choice).\n\nAlso not clear if for every release of openstack a driver document owner must do something, even if something is just reaffirmation that  no changes to driver documentation are needed for this release.","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"ecb521c6af21bacc7ef6bee33810e84a420fda3d","unresolved":false,"context_lines":[{"line_number":150,"context_line":"full documentation to a minimal version."},{"line_number":151,"context_line":""},{"line_number":152,"context_line":"The documentation team will review vendor drivers and ensure that the"},{"line_number":153,"context_line":"various driver documents follow a consistent standard."},{"line_number":154,"context_line":""},{"line_number":155,"context_line":"Alternatives"},{"line_number":156,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_a49c906b","line":153,"in_reply_to":"ba7be1f8_581e620d","updated":"2015-03-03 07:25:39.000000000","message":"3rd party drivers can maintain their current documention in OpenStack as stated in the first paragraph.\n\nWe can refine this once we fine tune the process. Right now the expectation is that 3rd party vendors become active if something is outdated.","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"},{"author":{"_account_id":7160,"name":"arkady kanevsky","email":"akanevsk@redhat.com","username":"arkady"},"change_message_id":"ad5a609ba0552ca9963ef623dfc14ff5b7aaaa2f","unresolved":false,"context_lines":[{"line_number":150,"context_line":"full documentation to a minimal version."},{"line_number":151,"context_line":""},{"line_number":152,"context_line":"The documentation team will review vendor drivers and ensure that the"},{"line_number":153,"context_line":"various driver documents follow a consistent standard."},{"line_number":154,"context_line":""},{"line_number":155,"context_line":"Alternatives"},{"line_number":156,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":19,"id":"ba7be1f8_7b005501","line":153,"in_reply_to":"ba7be1f8_a49c906b","updated":"2015-03-03 18:05:57.000000000","message":"OK","commit_id":"4746aaecce9430bf00c355eb9c8230f877ab2b27"}]}