)]}'
{"reference/top-5-help-wanted.rst":[{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"528209305b1264bbd47478ab34ffaa8540955cd7","unresolved":false,"context_lines":[{"line_number":40,"context_line":"project, and respected mentors in the OpenStack community."},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"Interested? Contact the Documentation PTL (asettle) or the TC sponsor for"},{"line_number":43,"context_line":"this item (tbd)."}],"source_content_type":"text/x-rst","patch_set":1,"id":"df140735_8fc9b279","line":43,"updated":"2017-05-30 18:14:27.000000000","message":"I\u0027ll sponsor this one.","commit_id":"5cd060f2e29246b7bc0bcd75a50dfb9ba80384ea"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"abb411425183d443360dcfbcde2187c5a477cf55","unresolved":false,"context_lines":[{"line_number":30,"context_line":"The documentation team has been struggling with limited resources since the"},{"line_number":31,"context_line":"dawn of OpenStack, despite the heroic efforts of previous team members. An"},{"line_number":32,"context_line":"ambitious plan to further decentralize the Documentation team (and turn it"},{"line_number":33,"context_line":"into a guidance and mentoring support team) has been outlined. To be"},{"line_number":34,"context_line":"successful, this plan requires project teams to own their own documentation,"},{"line_number":35,"context_line":"which means that the role of documentation owners will be critical."},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"Volunteers for this role will drive this ambitious transition, by being"}],"source_content_type":"text/x-rst","patch_set":2,"id":"df140735_32ed588b","line":34,"range":{"start_line":33,"start_character":44,"end_line":34,"end_character":11},"updated":"2017-05-31 12:54:05.000000000","message":"Just for reference - could/should we point to the ML discussion? Just so we know here what we\u0027re talking about.","commit_id":"3d6a3ea597d025ed1ec9390ff75d6c929dba360b"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"01873d2f50166c018b96812427709b14dd0b2a9c","unresolved":false,"context_lines":[{"line_number":30,"context_line":"The documentation team has been struggling with limited resources since the"},{"line_number":31,"context_line":"dawn of OpenStack, despite the heroic efforts of previous team members. An"},{"line_number":32,"context_line":"ambitious plan to further decentralize the Documentation team (and turn it"},{"line_number":33,"context_line":"into a guidance and mentoring support team) has been outlined. To be"},{"line_number":34,"context_line":"successful, this plan requires project teams to own their own documentation,"},{"line_number":35,"context_line":"which means that the role of documentation owners will be critical."},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"Volunteers for this role will drive this ambitious transition, by being"}],"source_content_type":"text/x-rst","patch_set":2,"id":"df140735_83a174ac","line":34,"range":{"start_line":33,"start_character":44,"end_line":34,"end_character":11},"in_reply_to":"df140735_32ed588b","updated":"2017-05-31 14:06:50.000000000","message":"I agree having some context would be good. Rather than the mailing list, it might make more sense to link to the doc spec, when we have that ready. The spec would link to the thread, any etherpads, etc., so we have a single link to put here that gives them all the info they need.","commit_id":"3d6a3ea597d025ed1ec9390ff75d6c929dba360b"},{"author":{"_account_id":308,"name":"Thierry Carrez","email":"thierry@openstack.org","username":"ttx"},"change_message_id":"39b4e017fa84e06d58ad887c17ac89e7f4ffb3c7","unresolved":false,"context_lines":[{"line_number":30,"context_line":"The documentation team has been struggling with limited resources since the"},{"line_number":31,"context_line":"dawn of OpenStack, despite the heroic efforts of previous team members. An"},{"line_number":32,"context_line":"ambitious plan to further decentralize the Documentation team (and turn it"},{"line_number":33,"context_line":"into a guidance and mentoring support team) has been outlined. To be"},{"line_number":34,"context_line":"successful, this plan requires project teams to own their own documentation,"},{"line_number":35,"context_line":"which means that the role of documentation owners will be critical."},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"Volunteers for this role will drive this ambitious transition, by being"}],"source_content_type":"text/x-rst","patch_set":2,"id":"df140735_8bacd034","line":34,"range":{"start_line":33,"start_character":44,"end_line":34,"end_character":11},"in_reply_to":"df140735_83a174ac","updated":"2017-06-01 08:52:55.000000000","message":"Agreed, we should definitely add a link to the spec when available.","commit_id":"3d6a3ea597d025ed1ec9390ff75d6c929dba360b"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"7f0759168dcc982396671f1890394a4a5e213aac","unresolved":false,"context_lines":[{"line_number":34,"context_line":"successful, this plan requires project teams to own their own documentation,"},{"line_number":35,"context_line":"which means that the role of documentation owners will be critical."},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"Volunteers for this role will drive this ambitious transition, by being"},{"line_number":38,"context_line":"members of their project team and members of the new decentralized"},{"line_number":39,"context_line":"documentation team. They will become a reference go-to person in their"},{"line_number":40,"context_line":"project, and respected mentors in the OpenStack community."}],"source_content_type":"text/x-rst","patch_set":2,"id":"df140735_0a936351","line":37,"updated":"2017-06-07 15:10:45.000000000","message":"Is the ask for people to help with the transition laid out in the ML [0]? Or is it asking for steady contributions to the documentation of OpenStack long term? Or is it both?\n\n[0] http://lists.openstack.org/pipermail/openstack-dev/2017-May/117162.html","commit_id":"3d6a3ea597d025ed1ec9390ff75d6c929dba360b"},{"author":{"_account_id":308,"name":"Thierry Carrez","email":"thierry@openstack.org","username":"ttx"},"change_message_id":"45da14f5e819f75b7435f4e8f73d4ff186f9a1ab","unresolved":false,"context_lines":[{"line_number":34,"context_line":"successful, this plan requires project teams to own their own documentation,"},{"line_number":35,"context_line":"which means that the role of documentation owners will be critical."},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"Volunteers for this role will drive this ambitious transition, by being"},{"line_number":38,"context_line":"members of their project team and members of the new decentralized"},{"line_number":39,"context_line":"documentation team. They will become a reference go-to person in their"},{"line_number":40,"context_line":"project, and respected mentors in the OpenStack community."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f231b9d_0ea01ff4","line":37,"in_reply_to":"df140735_0a936351","updated":"2017-06-12 08:49:14.000000000","message":"Will add a small bit to clarify that.","commit_id":"3d6a3ea597d025ed1ec9390ff75d6c929dba360b"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"7f0759168dcc982396671f1890394a4a5e213aac","unresolved":false,"context_lines":[{"line_number":37,"context_line":"Volunteers for this role will drive this ambitious transition, by being"},{"line_number":38,"context_line":"members of their project team and members of the new decentralized"},{"line_number":39,"context_line":"documentation team. They will become a reference go-to person in their"},{"line_number":40,"context_line":"project, and respected mentors in the OpenStack community."},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"Interested? Contact the Documentation PTL (asettle) or the TC sponsor for"},{"line_number":43,"context_line":"this item (dhellmann)."}],"source_content_type":"text/x-rst","patch_set":2,"id":"df140735_6aef7fe9","line":40,"updated":"2017-06-07 15:10:45.000000000","message":"I was going to ask this in the previous review that added the top-5-list, but it might be better suited here.\n\nIs it fair to try and provide an investment estimate for the sponsor, or is that something that gets established as they work with the PTL and TC sponsor? Do we foresee a sponsor signing up to contribute resources to an effort only to have them pull those resources because they didn\u0027t realize the commitment requirements or investment requirements?\n\nThis medium might not be the best way to communicate that information and that is reasonable. But I wonder if we need a section that says \"for commitment estimates, please talk to the TC sponsor and PTL of the affected project\".\n\nI\u0027m only suggesting it in case it helps each party understand expectations. Otherwise, I think this does a great job of relaying the need.","commit_id":"3d6a3ea597d025ed1ec9390ff75d6c929dba360b"},{"author":{"_account_id":308,"name":"Thierry Carrez","email":"thierry@openstack.org","username":"ttx"},"change_message_id":"45da14f5e819f75b7435f4e8f73d4ff186f9a1ab","unresolved":false,"context_lines":[{"line_number":37,"context_line":"Volunteers for this role will drive this ambitious transition, by being"},{"line_number":38,"context_line":"members of their project team and members of the new decentralized"},{"line_number":39,"context_line":"documentation team. They will become a reference go-to person in their"},{"line_number":40,"context_line":"project, and respected mentors in the OpenStack community."},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"Interested? Contact the Documentation PTL (asettle) or the TC sponsor for"},{"line_number":43,"context_line":"this item (dhellmann)."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7f231b9d_6377ac3c","line":40,"in_reply_to":"bf091321_04212cfc","updated":"2017-06-12 08:49:14.000000000","message":"Indeed a good point. I added a paragraph to the previous review to cover that.","commit_id":"3d6a3ea597d025ed1ec9390ff75d6c929dba360b"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"597c68f5b4bad626b7f1291cb9932e0f7cc8f138","unresolved":false,"context_lines":[{"line_number":37,"context_line":"Volunteers for this role will drive this ambitious transition, by being"},{"line_number":38,"context_line":"members of their project team and members of the new decentralized"},{"line_number":39,"context_line":"documentation team. They will become a reference go-to person in their"},{"line_number":40,"context_line":"project, and respected mentors in the OpenStack community."},{"line_number":41,"context_line":""},{"line_number":42,"context_line":"Interested? Contact the Documentation PTL (asettle) or the TC sponsor for"},{"line_number":43,"context_line":"this item (dhellmann)."}],"source_content_type":"text/x-rst","patch_set":2,"id":"bf091321_04212cfc","line":40,"in_reply_to":"df140735_6aef7fe9","updated":"2017-06-08 09:28:33.000000000","message":"Good point Lance, +1","commit_id":"3d6a3ea597d025ed1ec9390ff75d6c929dba360b"},{"author":{"_account_id":23186,"name":"Felipe Monteiro","email":"felipe.carneiro.monteiro@gmail.com","username":"felipe.monteiro"},"change_message_id":"e6a56a937dc33f5f9e895af1e46228a6ea553a95","unresolved":false,"context_lines":[{"line_number":26,"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"},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"The #1 pain point in OpenStack, especially for new potential adopters, is"},{"line_number":29,"context_line":"complexity. While cutting down complexity everwhere we can is critical,"},{"line_number":30,"context_line":"proper documentation is essential in addressing that complexity. It directly"},{"line_number":31,"context_line":"benefits operators and users of OpenStack, but also facilitates ramping up"},{"line_number":32,"context_line":"new direct contributors to the project itself."}],"source_content_type":"text/x-rst","patch_set":3,"id":"7f231b9d_75fa62bd","line":29,"range":{"start_line":29,"start_character":42,"end_line":29,"end_character":51},"updated":"2017-06-14 15:43:53.000000000","message":"everywhere","commit_id":"09b5fda7c1b84545befeae81cb6282e904fec31b"}]}