)]}'
{"doc/source/contributing/organization-guide.rst":[{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"66aebedb957ce51b079762bd4049e06a2d74a6fa","unresolved":false,"context_lines":[{"line_number":1,"context_line":"###############################"},{"line_number":2,"context_line":"Contributing Organization Guide"},{"line_number":3,"context_line":"###############################"},{"line_number":4,"context_line":""},{"line_number":5,"context_line":"What is the Contributing Organization Guide?"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_6cfb0d7b","line":2,"range":{"start_line":2,"start_character":0,"end_line":2,"end_character":31},"updated":"2018-06-28 06:00:14.000000000","message":"The etherpad mentions we could all it something like:\n\n  For Managers","commit_id":"223f8d61c5e5aebd9ef967b9e56d4524be04d65a"},{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"66aebedb957ce51b079762bd4049e06a2d74a6fa","unresolved":false,"context_lines":[{"line_number":2,"context_line":"Contributing Organization Guide"},{"line_number":3,"context_line":"###############################"},{"line_number":4,"context_line":""},{"line_number":5,"context_line":"What is the Contributing Organization Guide?"},{"line_number":6,"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":7,"context_line":""},{"line_number":8,"context_line":"Recommendations"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_0c4139a7","line":5,"range":{"start_line":5,"start_character":0,"end_line":5,"end_character":43},"updated":"2018-06-28 06:00:14.000000000","message":"Every other page had this so added it. But if it\u0027s directly for managers and we want to keep the document shorter we may decide to use a different layout.","commit_id":"223f8d61c5e5aebd9ef967b9e56d4524be04d65a"},{"author":{"_account_id":5263,"name":"Jeremy Stanley","display_name":"fungi","email":"fungi@yuggoth.org","username":"fungi","status":"missing, presumed fed"},"change_message_id":"fb420e9fb056d7b4d3e7cfd362863700b8e3b267","unresolved":false,"context_lines":[{"line_number":2,"context_line":"Contributing Organization Guide"},{"line_number":3,"context_line":"###############################"},{"line_number":4,"context_line":""},{"line_number":5,"context_line":"What is the Contributing Organization Guide?"},{"line_number":6,"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":7,"context_line":""},{"line_number":8,"context_line":"Recommendations"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_571275b5","line":5,"updated":"2018-07-10 18:44:01.000000000","message":"Getting input from the SIGs ML with a mention on the dev ML linking to that thread sounds like a good way to diversify feedback.","commit_id":"223f8d61c5e5aebd9ef967b9e56d4524be04d65a"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"cc22fc2b8adbd9aaea123838904f73ac162fb06e","unresolved":false,"context_lines":[{"line_number":2,"context_line":"Contributing Organization Guide"},{"line_number":3,"context_line":"###############################"},{"line_number":4,"context_line":""},{"line_number":5,"context_line":"What is the Contributing Organization Guide?"},{"line_number":6,"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":7,"context_line":""},{"line_number":8,"context_line":"Recommendations"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_191e7973","line":5,"range":{"start_line":5,"start_character":0,"end_line":5,"end_character":43},"in_reply_to":"5f7c97a3_0c4139a7","updated":"2018-07-10 14:04:02.000000000","message":"I think that would be a good thing to include in this section. Something like- base requirements for employees looking to contribute to OpenStack. Or similar. I imagine once more eyes get on this people will have opinions on the phrasing. \n\nMaybe we should publicize this patch on the SIG and dev lists to try to get it some attention?","commit_id":"223f8d61c5e5aebd9ef967b9e56d4524be04d65a"},{"author":{"_account_id":15993,"name":"Amy Marrich","display_name":"Amy Marrich (spotz)","email":"amy@demarco.com","username":"amarrich"},"change_message_id":"e3959dd76b4b18fb05065f546eee0ab3e33f03c3","unresolved":false,"context_lines":[{"line_number":13,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"* Access to review.openstack.org port 29418/tcp (Gerrit SSH API)"},{"line_number":16,"context_line":"* Access to chat.freenode.net port 6697/tcp (IRC communication)"},{"line_number":17,"context_line":"* Ability to receive E-mail from and send E-mail to addresses at lists.openstack.org (mailing lists)"},{"line_number":18,"context_line":"* Permitting use of external mail services to handle the intake from community MLs"},{"line_number":19,"context_line":"* Consider an exception for standard email footers on emails being sent to the community MLs"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_f71dc176","line":16,"updated":"2018-07-10 19:02:28.000000000","message":"If utilizing a bouncer you can use port 443 to the bouncer","commit_id":"223f8d61c5e5aebd9ef967b9e56d4524be04d65a"},{"author":{"_account_id":8482,"name":"Colleen Murphy","email":"colleen@gazlene.net","username":"krinkle"},"change_message_id":"734c0361c46bca10d1731ec687f2ad1318436252","unresolved":false,"context_lines":[{"line_number":14,"context_line":""},{"line_number":15,"context_line":"* Access to review.openstack.org port 29418/tcp (Gerrit SSH API)"},{"line_number":16,"context_line":"* Access to chat.freenode.net port 6697/tcp (IRC communication)"},{"line_number":17,"context_line":"* Ability to receive E-mail from and send E-mail to addresses at lists.openstack.org (mailing lists)"},{"line_number":18,"context_line":"* Permitting use of external mail services to handle the intake from community MLs"},{"line_number":19,"context_line":"* Consider an exception for standard email footers on emails being sent to the community MLs"},{"line_number":20,"context_line":"* Permission to run Linux and install other open source software on work systems"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_7493f400","line":17,"updated":"2018-07-11 08:06:43.000000000","message":"Maybe a link to the other parts of the contributor guide that describes what these things are would be nice? (to answer the question why would my employee need access to these things)","commit_id":"223f8d61c5e5aebd9ef967b9e56d4524be04d65a"},{"author":{"_account_id":8482,"name":"Colleen Murphy","email":"colleen@gazlene.net","username":"krinkle"},"change_message_id":"734c0361c46bca10d1731ec687f2ad1318436252","unresolved":false,"context_lines":[{"line_number":15,"context_line":"* Access to review.openstack.org port 29418/tcp (Gerrit SSH API)"},{"line_number":16,"context_line":"* Access to chat.freenode.net port 6697/tcp (IRC communication)"},{"line_number":17,"context_line":"* Ability to receive E-mail from and send E-mail to addresses at lists.openstack.org (mailing lists)"},{"line_number":18,"context_line":"* Permitting use of external mail services to handle the intake from community MLs"},{"line_number":19,"context_line":"* Consider an exception for standard email footers on emails being sent to the community MLs"},{"line_number":20,"context_line":"* Permission to run Linux and install other open source software on work systems"},{"line_number":21,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_8877909f","line":18,"updated":"2018-07-11 08:06:43.000000000","message":"I know we talked about this one but it feels like the odd one out. Personally I\u0027ve had problems with Gmail handling the mailing list, and on the other hand my corporate email server seems to handle it fine.\n\nMaybe it could be bundled into the bulletpoint above it - somehow they need access to the mailing list, whether that\u0027s handled by making the corporate email permissive enough or by allowing use of personal email.","commit_id":"223f8d61c5e5aebd9ef967b9e56d4524be04d65a"},{"author":{"_account_id":8482,"name":"Colleen Murphy","email":"colleen@gazlene.net","username":"krinkle"},"change_message_id":"734c0361c46bca10d1731ec687f2ad1318436252","unresolved":false,"context_lines":[{"line_number":17,"context_line":"* Ability to receive E-mail from and send E-mail to addresses at lists.openstack.org (mailing lists)"},{"line_number":18,"context_line":"* Permitting use of external mail services to handle the intake from community MLs"},{"line_number":19,"context_line":"* Consider an exception for standard email footers on emails being sent to the community MLs"},{"line_number":20,"context_line":"* Permission to run Linux and install other open source software on work systems"},{"line_number":21,"context_line":""},{"line_number":22,"context_line":"Non-Technical"},{"line_number":23,"context_line":"-------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_68fd5406","line":20,"range":{"start_line":20,"start_character":68,"end_line":20,"end_character":80},"updated":"2018-07-11 08:06:43.000000000","message":"Slightly ambiguous wording, maybe \"employer-supplied hardware\"","commit_id":"223f8d61c5e5aebd9ef967b9e56d4524be04d65a"},{"author":{"_account_id":8482,"name":"Colleen Murphy","email":"colleen@gazlene.net","username":"krinkle"},"change_message_id":"734c0361c46bca10d1731ec687f2ad1318436252","unresolved":false,"context_lines":[{"line_number":23,"context_line":"-------------"},{"line_number":24,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":25,"context_line":""},{"line_number":26,"context_line":"* Permission to occasionally work outside typical office hours- emailing, irc conversations, etc"},{"line_number":27,"context_line":"* Permission to agree to the OpenStack ICLA (required)"},{"line_number":28,"context_line":"* A process to clear contributions from IP point of view"},{"line_number":29,"context_line":"* Permission and budget to send contributors to events"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_889c70bf","line":26,"updated":"2018-07-11 08:06:43.000000000","message":"Rationale would be good here (we\u0027re a global community, etc)","commit_id":"223f8d61c5e5aebd9ef967b9e56d4524be04d65a"},{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"66aebedb957ce51b079762bd4049e06a2d74a6fa","unresolved":false,"context_lines":[{"line_number":33,"context_line":"   * Permission to agree with terms of becoming an OpenStack Foundation Individual Member"},{"line_number":34,"context_line":"* Consider signing up as a contributing organization member"},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"Community Culture (or education?)"},{"line_number":37,"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"},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"NOTE: maybe this section should live under recommendations as well?"}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_4c2091f9","line":36,"range":{"start_line":36,"start_character":18,"end_line":36,"end_character":33},"updated":"2018-06-28 06:00:14.000000000","message":"in the etherpad there was a section called education.","commit_id":"223f8d61c5e5aebd9ef967b9e56d4524be04d65a"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"cc22fc2b8adbd9aaea123838904f73ac162fb06e","unresolved":false,"context_lines":[{"line_number":43,"context_line":"* Timezones"},{"line_number":44,"context_line":"* Titles held by community members are temporary and activities are not really linked to titles"},{"line_number":45,"context_line":"* Forks are bad"},{"line_number":46,"context_line":"   * citing articles about how maintaining forks is generally an expensive and painful process (via links to further reading on effective open source community involvement)"},{"line_number":47,"context_line":"* Good metrics are hard https://en.wikipedia.org/wiki/Goodhart%27s_law"},{"line_number":48,"context_line":"* Focusing staff on particular project areas, or towards particular goals is more effective than asking them to track activity over many projects"},{"line_number":49,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_b4166c49","line":48,"range":{"start_line":46,"start_character":96,"end_line":48,"end_character":108},"updated":"2018-07-10 14:04:02.000000000","message":"Should wrap these lines.","commit_id":"223f8d61c5e5aebd9ef967b9e56d4524be04d65a"},{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"66aebedb957ce51b079762bd4049e06a2d74a6fa","unresolved":false,"context_lines":[{"line_number":46,"context_line":"   * citing articles about how maintaining forks is generally an expensive and painful process (via links to further reading on effective open source community involvement)"},{"line_number":47,"context_line":"* Good metrics are hard https://en.wikipedia.org/wiki/Goodhart%27s_law"},{"line_number":48,"context_line":"* Focusing staff on particular project areas, or towards particular goals is more effective than asking them to track activity over many projects"},{"line_number":49,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"5f7c97a3_ac5da57d","line":49,"updated":"2018-06-28 06:00:14.000000000","message":"Haven\u0027t added a \"strategies\" section (from one of the etherpads).","commit_id":"223f8d61c5e5aebd9ef967b9e56d4524be04d65a"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"b9376b8d11ee00a4992d2f1741bb9a3f013d9e8f","unresolved":false,"context_lines":[{"line_number":5,"context_line":"What is the Contributing Organization Guide?"},{"line_number":6,"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":7,"context_line":""},{"line_number":8,"context_line":"A guide outlining the base requirements and recommendations for employees looking to"},{"line_number":9,"context_line":"contribute to OpenStack."},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Recommendations"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_d75e33e8","line":8,"range":{"start_line":8,"start_character":60,"end_line":8,"end_character":73},"updated":"2018-08-31 06:43:54.000000000","message":"Isn\u0027t this for the employers of the employees?","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"45958ea2e7b6dd0bc93aea89a1bbfae7a459b676","unresolved":false,"context_lines":[{"line_number":5,"context_line":"What is the Contributing Organization Guide?"},{"line_number":6,"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":7,"context_line":""},{"line_number":8,"context_line":"A guide outlining the base requirements and recommendations for employees looking to"},{"line_number":9,"context_line":"contribute to OpenStack."},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Recommendations"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_54b9ba76","line":8,"range":{"start_line":8,"start_character":82,"end_line":8,"end_character":84},"updated":"2018-08-31 11:30:59.000000000","message":"This line is too long for pep8","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":12404,"name":"Rico Lin","email":"ricolin@ricolky.com","username":"rico.lin"},"change_message_id":"a50245c51f85caba6dcd554084469354f227bd6f","unresolved":false,"context_lines":[{"line_number":7,"context_line":""},{"line_number":8,"context_line":"A guide outlining the base requirements and recommendations for employees looking to"},{"line_number":9,"context_line":"contribute to OpenStack."},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Recommendations"},{"line_number":12,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":13,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_42520a14","line":10,"updated":"2018-09-05 11:57:20.000000000","message":"It’s nicer IMO if we can have sections for “Why Your Organization needs this guideline”, “What are common questions”.","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":12404,"name":"Rico Lin","email":"ricolin@ricolky.com","username":"rico.lin"},"change_message_id":"a50245c51f85caba6dcd554084469354f227bd6f","unresolved":false,"context_lines":[{"line_number":11,"context_line":"Recommendations"},{"line_number":12,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":13,"context_line":""},{"line_number":14,"context_line":"Technical"},{"line_number":15,"context_line":"---------"},{"line_number":16,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":17,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_3dadaf83","line":14,"range":{"start_line":14,"start_character":0,"end_line":14,"end_character":9},"updated":"2018-09-05 11:57:20.000000000","message":"IMO it might make sense to give groups information that employers can contect to if they face issues on specific domain(technical/non-technical/community)","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"b9376b8d11ee00a4992d2f1741bb9a3f013d9e8f","unresolved":false,"context_lines":[{"line_number":15,"context_line":"---------"},{"line_number":16,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"* Access to review.openstack.org port 29418/tcp (Gerrit SSH API)"},{"line_number":19,"context_line":"* Access to chat.freenode.net port 6697/tcp (IRC communication)"},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"  * If utilizing an IRC bouncer port 443, to the bouncer, may be used."}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_b742970e","line":18,"range":{"start_line":18,"start_character":2,"end_line":18,"end_character":32},"updated":"2018-08-31 06:43:54.000000000","message":"Maybe we can mention tsocks and SOCKS servers as a workaround.","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"b9376b8d11ee00a4992d2f1741bb9a3f013d9e8f","unresolved":false,"context_lines":[{"line_number":16,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"* Access to review.openstack.org port 29418/tcp (Gerrit SSH API)"},{"line_number":19,"context_line":"* Access to chat.freenode.net port 6697/tcp (IRC communication)"},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"  * If utilizing an IRC bouncer port 443, to the bouncer, may be used."},{"line_number":22,"context_line":"  * See https://docs.openstack.org/contributors/common/communication.html#irc"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_7744ff19","line":19,"range":{"start_line":19,"start_character":2,"end_line":19,"end_character":25},"updated":"2018-08-31 06:43:54.000000000","message":"Maybe we can mention the possibility to use a web based IRC client (and the possibility that organisations can subscribe their employees to these services)","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"45958ea2e7b6dd0bc93aea89a1bbfae7a459b676","unresolved":false,"context_lines":[{"line_number":26,"context_line":"  * Ability to receive E-mail from and send E-mail to addresses at"},{"line_number":27,"context_line":"    lists.openstack.org (mailing lists)"},{"line_number":28,"context_line":""},{"line_number":29,"context_line":"    * Mailing list can be high traffic, consider permitting use of external mail"},{"line_number":30,"context_line":"      services to handle the intake from community MLs"},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"  * Consider an exception for standard email footers on emails being sent to the"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_14ab421e","line":29,"range":{"start_line":29,"start_character":76,"end_line":29,"end_character":80},"updated":"2018-08-31 11:30:59.000000000","message":"This line is too long for pep8","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"45958ea2e7b6dd0bc93aea89a1bbfae7a459b676","unresolved":false,"context_lines":[{"line_number":29,"context_line":"    * Mailing list can be high traffic, consider permitting use of external mail"},{"line_number":30,"context_line":"      services to handle the intake from community MLs"},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"  * Consider an exception for standard email footers on emails being sent to the"},{"line_number":33,"context_line":"    community MLs"},{"line_number":34,"context_line":"  * See https://docs.openstack.org/contributors/common/communication.html#mailing-lists-ml"},{"line_number":35,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_b4a92e25","line":32,"range":{"start_line":32,"start_character":77,"end_line":32,"end_character":80},"updated":"2018-08-31 11:30:59.000000000","message":"This line is too long for pep8","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"45958ea2e7b6dd0bc93aea89a1bbfae7a459b676","unresolved":false,"context_lines":[{"line_number":33,"context_line":"    community MLs"},{"line_number":34,"context_line":"  * See https://docs.openstack.org/contributors/common/communication.html#mailing-lists-ml"},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"* Permission to run Linux and install other open source software on employer-supplied"},{"line_number":37,"context_line":"  hardware."},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"Non-Technical"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_d4a4ea4d","line":36,"range":{"start_line":36,"start_character":78,"end_line":36,"end_character":85},"updated":"2018-08-31 11:30:59.000000000","message":"This line is too long for pep8","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"45958ea2e7b6dd0bc93aea89a1bbfae7a459b676","unresolved":false,"context_lines":[{"line_number":40,"context_line":"-------------"},{"line_number":41,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"OpenStack is a global community and as such has developers from all over the globe."},{"line_number":44,"context_line":"Interaction with the community means working and interacting with people from different"},{"line_number":45,"context_line":"timezones and cultures, as such there are other non-technical recommendations that help"},{"line_number":46,"context_line":"facilitate engagement in the OpenStack community, these include:"},{"line_number":47,"context_line":""},{"line_number":48,"context_line":"* Permission to occasionally work outside typical office hours"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_94643223","line":45,"range":{"start_line":43,"start_character":0,"end_line":45,"end_character":87},"updated":"2018-08-31 11:30:59.000000000","message":"These lines are too long for pep8","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"ec8a085fcc0dfe2acc2a8a5726e43bb73079553f","unresolved":false,"context_lines":[{"line_number":49,"context_line":""},{"line_number":50,"context_line":"  * emailing, irc conversations, etc"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"* Permission to agree to the OpenStack ICLA (required)"},{"line_number":53,"context_line":"* A process to clear contributions from IP point of view"},{"line_number":54,"context_line":"* Permission and budget to send contributors to events"},{"line_number":55,"context_line":"* Expectation of travel to at least some events- doesn\u0027t need to be all"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_89e5ed3a","line":52,"range":{"start_line":52,"start_character":2,"end_line":52,"end_character":54},"updated":"2018-08-31 20:46:20.000000000","message":"this is under a section Recommendations\u003eNon-Technical.\n\nIn one of my previous employers, that was the hardest to get, and it was at that time mandatory (most projects still require that, but there were discussions to make it optional in the past).\n\nSo I think this should be highlighted as a very big point, instead of a recommendation for now.\n\nMaybe move this to a \"Required\" section, the same way as access the git repositories whether by ssh or http.","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"7c67aaf993f8210867237eeaa250eb96a1d1a39f","unresolved":false,"context_lines":[{"line_number":49,"context_line":""},{"line_number":50,"context_line":"  * emailing, irc conversations, etc"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"* Permission to agree to the OpenStack ICLA (required)"},{"line_number":53,"context_line":"* A process to clear contributions from IP point of view"},{"line_number":54,"context_line":"* Permission and budget to send contributors to events"},{"line_number":55,"context_line":"* Expectation of travel to at least some events- doesn\u0027t need to be all"},{"line_number":56,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_bdbe9562","line":53,"range":{"start_line":52,"start_character":54,"end_line":53,"end_character":56},"updated":"2018-08-24 00:44:02.000000000","message":"Is this kind of a sub bullet point from the one on line 52?","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"b9376b8d11ee00a4992d2f1741bb9a3f013d9e8f","unresolved":false,"context_lines":[{"line_number":49,"context_line":""},{"line_number":50,"context_line":"  * emailing, irc conversations, etc"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"* Permission to agree to the OpenStack ICLA (required)"},{"line_number":53,"context_line":"* A process to clear contributions from IP point of view"},{"line_number":54,"context_line":"* Permission and budget to send contributors to events"},{"line_number":55,"context_line":"* Expectation of travel to at least some events- doesn\u0027t need to be all"},{"line_number":56,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_b7105702","line":53,"range":{"start_line":52,"start_character":54,"end_line":53,"end_character":56},"in_reply_to":"3f79a3b5_bdbe9562","updated":"2018-08-31 06:43:54.000000000","message":"I think this should be a separate point.","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"7c67aaf993f8210867237eeaa250eb96a1d1a39f","unresolved":false,"context_lines":[{"line_number":51,"context_line":""},{"line_number":52,"context_line":"* Permission to agree to the OpenStack ICLA (required)"},{"line_number":53,"context_line":"* A process to clear contributions from IP point of view"},{"line_number":54,"context_line":"* Permission and budget to send contributors to events"},{"line_number":55,"context_line":"* Expectation of travel to at least some events- doesn\u0027t need to be all"},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"  * Should be prepared to write permission letter/visa letters/necessary letters for"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_fd8e4dcf","line":54,"range":{"start_line":54,"start_character":48,"end_line":54,"end_character":54},"updated":"2018-08-24 00:44:02.000000000","message":"We might want to elaborate on this and say the PTG \u0026/or Summit \u0026 Forum","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"45958ea2e7b6dd0bc93aea89a1bbfae7a459b676","unresolved":false,"context_lines":[{"line_number":54,"context_line":"* Permission and budget to send contributors to events"},{"line_number":55,"context_line":"* Expectation of travel to at least some events- doesn\u0027t need to be all"},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"  * Should be prepared to write permission letter/visa letters/necessary letters for"},{"line_number":58,"context_line":"    getting visas"},{"line_number":59,"context_line":"  * The letters/decisions made on travel should be given out, ideally weeks or more,"},{"line_number":60,"context_line":"    in advance"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_546e9a00","line":57,"range":{"start_line":57,"start_character":81,"end_line":57,"end_character":84},"updated":"2018-08-31 11:30:59.000000000","message":"This line is too long for pep8","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"45958ea2e7b6dd0bc93aea89a1bbfae7a459b676","unresolved":false,"context_lines":[{"line_number":56,"context_line":""},{"line_number":57,"context_line":"  * Should be prepared to write permission letter/visa letters/necessary letters for"},{"line_number":58,"context_line":"    getting visas"},{"line_number":59,"context_line":"  * The letters/decisions made on travel should be given out, ideally weeks or more,"},{"line_number":60,"context_line":"    in advance"},{"line_number":61,"context_line":"  * Permission to agree with terms of becoming an OpenStack Foundation Individual Member"},{"line_number":62,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_b47e0ead","line":59,"range":{"start_line":59,"start_character":79,"end_line":59,"end_character":84},"updated":"2018-08-31 11:30:59.000000000","message":"This line is too long for pep8","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"7c67aaf993f8210867237eeaa250eb96a1d1a39f","unresolved":false,"context_lines":[{"line_number":58,"context_line":"    getting visas"},{"line_number":59,"context_line":"  * The letters/decisions made on travel should be given out, ideally weeks or more,"},{"line_number":60,"context_line":"    in advance"},{"line_number":61,"context_line":"  * Permission to agree with terms of becoming an OpenStack Foundation Individual Member"},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"* Consider signing up as a contributing organization member"},{"line_number":64,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_9db9597a","line":61,"range":{"start_line":61,"start_character":4,"end_line":61,"end_character":88},"updated":"2018-08-24 00:44:02.000000000","message":"I don\u0027t think this is meant to be a sub bullet of line 55?","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"45958ea2e7b6dd0bc93aea89a1bbfae7a459b676","unresolved":false,"context_lines":[{"line_number":58,"context_line":"    getting visas"},{"line_number":59,"context_line":"  * The letters/decisions made on travel should be given out, ideally weeks or more,"},{"line_number":60,"context_line":"    in advance"},{"line_number":61,"context_line":"  * Permission to agree with terms of becoming an OpenStack Foundation Individual Member"},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"* Consider signing up as a contributing organization member"},{"line_number":64,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_d4794ac5","line":61,"range":{"start_line":61,"start_character":82,"end_line":61,"end_character":88},"updated":"2018-08-31 11:30:59.000000000","message":"This line is too long for pep8","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"7c67aaf993f8210867237eeaa250eb96a1d1a39f","unresolved":false,"context_lines":[{"line_number":60,"context_line":"    in advance"},{"line_number":61,"context_line":"  * Permission to agree with terms of becoming an OpenStack Foundation Individual Member"},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"* Consider signing up as a contributing organization member"},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"Community Culture (or education?)"},{"line_number":66,"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"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_1da54947","line":63,"updated":"2018-08-24 00:44:02.000000000","message":"\u0027... as an organisation?\u0027","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"45958ea2e7b6dd0bc93aea89a1bbfae7a459b676","unresolved":false,"context_lines":[{"line_number":70,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":71,"context_line":""},{"line_number":72,"context_line":"* Timezones"},{"line_number":73,"context_line":"* Titles held by community members are temporary and activities are not really linked"},{"line_number":74,"context_line":"  to titles"},{"line_number":75,"context_line":"* Forks are bad"},{"line_number":76,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_d452aa35","line":73,"range":{"start_line":73,"start_character":79,"end_line":73,"end_character":85},"updated":"2018-08-31 11:30:59.000000000","message":"This line is too long for pep8","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"45958ea2e7b6dd0bc93aea89a1bbfae7a459b676","unresolved":false,"context_lines":[{"line_number":74,"context_line":"  to titles"},{"line_number":75,"context_line":"* Forks are bad"},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"  * citing articles about how maintaining forks is generally an expensive and painful"},{"line_number":78,"context_line":"    process (via links to further reading on effective open source community involvement)"},{"line_number":79,"context_line":""},{"line_number":80,"context_line":"* Good metrics are hard https://en.wikipedia.org/wiki/Goodhart%27s_law"},{"line_number":81,"context_line":"* Focusing staff on particular project areas, or towards particular goals is more"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_34399ef1","line":78,"range":{"start_line":77,"start_character":0,"end_line":78,"end_character":89},"updated":"2018-08-31 11:30:59.000000000","message":"These lines are too long for pep8","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"45958ea2e7b6dd0bc93aea89a1bbfae7a459b676","unresolved":false,"context_lines":[{"line_number":78,"context_line":"    process (via links to further reading on effective open source community involvement)"},{"line_number":79,"context_line":""},{"line_number":80,"context_line":"* Good metrics are hard https://en.wikipedia.org/wiki/Goodhart%27s_law"},{"line_number":81,"context_line":"* Focusing staff on particular project areas, or towards particular goals is more"},{"line_number":82,"context_line":"  effective than asking them to track activity over many projects"},{"line_number":83,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3f79a3b5_f42246ba","line":81,"range":{"start_line":81,"start_character":76,"end_line":81,"end_character":81},"updated":"2018-08-31 11:30:59.000000000","message":"This line is too long for pep8","commit_id":"c2cbd685c45c959a2d390b9dbaa236dae8335016"},{"author":{"_account_id":12404,"name":"Rico Lin","email":"ricolin@ricolky.com","username":"rico.lin"},"change_message_id":"9b9c343841e5f85e8348d0d3339315728e2760d5","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"Technical"},{"line_number":15,"context_line":"---------"},{"line_number":16,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"* Access to review.openstack.org port 29418/tcp (Gerrit SSH API)"},{"line_number":19,"context_line":"* Access to chat.freenode.net port 6697/tcp (IRC communication)"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_e6f8c34a","line":16,"updated":"2018-09-21 06:57:09.000000000","message":"Why?:\n* Why we need to send technical people into the community?\n  With technical people in the community, you will find it\u0027s easier to trigger development tasks or discussions in the community to get the best chance of integrating with your business/product plan. You need people to maintain your product, and so as the community needs people to maintain projects in each release cycle and make development going. There are multiple chances in each release cycle to trigger development tasks in the community. Bring more technical decision to the community will help you get more feedback and guideline from developers and operators globally. Also, help them to make better cycle goals which also consider as a benefit for you too.\n* How many people you should send?\n  Depends on your own plan, but try to cover the range of project services that you\u0027re using or plan to use for your services. Because you might want to know the health status for that service or find more discussion or resources for planning that architecture for your services, also possible to plan for integrating before you can directly adopt that service. The more people you give, the better attention your feature will get. To provide more reviewer (or even core reviewer) definitely will help to merge your implementation to projects.\n* How long they should be there?\n  The ideal answer is to give the technical people as many percentages of time that you can give, and as long as possible. For current development culture, your organization usually got multiple tools to maintain and integrate with. Now that usually turn out to get multiple engineers to spend 20% (or less) of their time on some specific community domain. As a common suggestion, to have one person, fully concentrate on the specific domain is way more efficient to have five people and with less than 20% of their time. Because it helps when you can provide continuously input or feedback to tasks that you set as high priority. And if you can only provide 20% of their time (which not as ideal as 80% for sure), try to make sure they all follow release cycle development. As I mentioned, there are multiple chances in each release cycle to trigger development tasks, usually in team meeting around each milestone, and on face-to-face events like PTG, Summit, or OpenInfraDay. So if your technical person can at least be there and keep pushing tasks till completed. Again, it\u0027s more efficient to have dedicated people assign to community development. Because communication take a big part of development, and it helps to accelerate the process when your technical people understand that service and people who work on that service deeply. It\u0027s also easier to trigger cross-project/cross-community development too.\n* Why you need to sync with the technical community?\n  If you think it\u0027s important to reach better control (or knowledge) of your own infrastructure or even capable to development features or fix issues than it\u0027s clear that the best way is to have people inside the community. One might wonder if they can implement their own features in their own product, why they even need to sync with the community? As an experience, you always need to maintain your product for long-term, and eventually, you will reach a point that you would like to upgrade it. If you do not sync with upstream, you will find yourself in a very difficult situation to spend way to much time in solving the conflicts and not mention when you need to upgrade the second time. On the other hand, when you try to design features or to solve issues, your technical team can always get more experiences or more thoughts on how to make the right implementation and how to avoid some failure design which others might already try.","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":12404,"name":"Rico Lin","email":"ricolin@ricolky.com","username":"rico.lin"},"change_message_id":"9b9c343841e5f85e8348d0d3339315728e2760d5","unresolved":false,"context_lines":[{"line_number":14,"context_line":"Technical"},{"line_number":15,"context_line":"---------"},{"line_number":16,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"* Access to review.openstack.org port 29418/tcp (Gerrit SSH API)"},{"line_number":19,"context_line":"* Access to chat.freenode.net port 6697/tcp (IRC communication)"},{"line_number":20,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_869d4f0a","line":17,"updated":"2018-09-21 06:57:09.000000000","message":"What you should settle:","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"c494d6906371d384c6fc71dc35b9af6088b2390f","unresolved":false,"context_lines":[{"line_number":15,"context_line":"---------"},{"line_number":16,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"* Access to review.openstack.org port 29418/tcp (Gerrit SSH API)"},{"line_number":19,"context_line":"* Access to chat.freenode.net port 6697/tcp (IRC communication)"},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"  * If utilizing an IRC bouncer port 443, to the bouncer, may be used."}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_d3d47249","line":18,"updated":"2018-09-20 16:05:26.000000000","message":"It\u0027s also possible to access gerrit via https at port 443, which may be simpler for a lot of contributors than getting a firewall rule changed. Maybe we need to group these things by \"actually needed\" vs. \"makes life easier\".","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"c494d6906371d384c6fc71dc35b9af6088b2390f","unresolved":false,"context_lines":[{"line_number":19,"context_line":"* Access to chat.freenode.net port 6697/tcp (IRC communication)"},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"  * If utilizing an IRC bouncer port 443, to the bouncer, may be used."},{"line_number":22,"context_line":"  * See https://docs.openstack.org/contributors/common/communication.html#irc"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"* Email considerations"},{"line_number":25,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_b35f76e3","line":22,"updated":"2018-09-20 16:05:26.000000000","message":"Should we mention services like irccloud, which allow browser-based access? Again, extremely strict firewall management may prevent opening a port directly to freenode.","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"c494d6906371d384c6fc71dc35b9af6088b2390f","unresolved":false,"context_lines":[{"line_number":30,"context_line":"      mail services to handle the intake from community MLs"},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"  * Consider an exception for standard email footers on emails being sent to"},{"line_number":33,"context_line":"    the community MLs"},{"line_number":34,"context_line":"  * See https://docs.openstack.org/contributors/common/communication.html#mailing-lists-ml"},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"* Permission to run Linux and install other open source software on"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_d30792c8","line":33,"updated":"2018-09-20 16:05:26.000000000","message":"spell out \"MLs\" as \"mailing lists\"","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"026125ba8fd2a0161f3c0d1d4159605cd40a9629","unresolved":false,"context_lines":[{"line_number":30,"context_line":"      mail services to handle the intake from community MLs"},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"  * Consider an exception for standard email footers on emails being sent to"},{"line_number":33,"context_line":"    the community MLs"},{"line_number":34,"context_line":"  * See https://docs.openstack.org/contributors/common/communication.html#mailing-lists-ml"},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"* Permission to run Linux and install other open source software on"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_cf3c45c2","line":33,"in_reply_to":"3f79a3b5_d30792c8","updated":"2018-10-10 03:45:38.000000000","message":"Done","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"c494d6906371d384c6fc71dc35b9af6088b2390f","unresolved":false,"context_lines":[{"line_number":34,"context_line":"  * See https://docs.openstack.org/contributors/common/communication.html#mailing-lists-ml"},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"* Permission to run Linux and install other open source software on"},{"line_number":37,"context_line":"  employer-supplied hardware."},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"Non-Technical"},{"line_number":40,"context_line":"-------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_930d9ae8","line":37,"updated":"2018-09-20 16:05:26.000000000","message":"This probably deserves some more details to explain why it is needed, since the person reading this may not understand that all of our development happens on Linux.","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":12404,"name":"Rico Lin","email":"ricolin@ricolky.com","username":"rico.lin"},"change_message_id":"9b9c343841e5f85e8348d0d3339315728e2760d5","unresolved":false,"context_lines":[{"line_number":35,"context_line":""},{"line_number":36,"context_line":"* Permission to run Linux and install other open source software on"},{"line_number":37,"context_line":"  employer-supplied hardware."},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"Non-Technical"},{"line_number":40,"context_line":"-------------"},{"line_number":41,"context_line":"TODO: We need to work on (from etherpad)"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_06893fc5","line":38,"updated":"2018-09-21 06:57:09.000000000","message":"* Permission to allow employees to bring technical discussions to upstream.\n\nWho can you contact with if any issues:\n* TC (Technical Committee)\n* SIG(Special Interest Group) or WG(Working Group)\n* Teams and it\u0027s PTL\n\nWhere you can find them:\n* On `IRC channel and meeting \u003chttp://eavesdrop.openstack.org/\u003e`_\n* On `mailing list \u003chttps://wiki.openstack.org/wiki/Mailing_Lists\u003e`_\n* On `OpenStack events \u003chttps://www.openstack.org/community/events/\u003e`_","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":6088,"name":"Emmet Hikory","email":"persia@shipstone.jp","username":"persia"},"change_message_id":"bef70da536b74748ea95f5df5e9011121e817fab","unresolved":false,"context_lines":[{"line_number":35,"context_line":""},{"line_number":36,"context_line":"* Permission to run Linux and install other open source software on"},{"line_number":37,"context_line":"  employer-supplied hardware."},{"line_number":38,"context_line":""},{"line_number":39,"context_line":"Non-Technical"},{"line_number":40,"context_line":"-------------"},{"line_number":41,"context_line":"TODO: We need to work on (from etherpad)"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_3f39d2ef","line":38,"in_reply_to":"3f79a3b5_06893fc5","updated":"2018-09-21 15:38:12.000000000","message":"While this is useful information, this document strives to avoid overlap with the contributor guide: it is specifically focused on organisational needs, rather than individual needs.  Given that we expect communications on IRC and mailing lists to be made by individuals, those are inappropriate here.  Event sponsorship is done at an organisational level, but I do not believe event sponsorship correlates with successful individual contribution by organisational representatives as well as most of the other topics discussed in this document.","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"c494d6906371d384c6fc71dc35b9af6088b2390f","unresolved":false,"context_lines":[{"line_number":41,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"OpenStack is a global community and as such has developers from all over the"},{"line_number":44,"context_line":"globe."},{"line_number":45,"context_line":"Interaction with the community means working and interacting with people from"},{"line_number":46,"context_line":"different timezones and cultures, as such there are other non-technical"},{"line_number":47,"context_line":"recommendations that help facilitate engagement in the OpenStack community,"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_53f382e7","line":44,"updated":"2018-09-20 16:05:26.000000000","message":"This is a bit redundant. Maybe just add a period after \"community\"?","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"026125ba8fd2a0161f3c0d1d4159605cd40a9629","unresolved":false,"context_lines":[{"line_number":41,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"OpenStack is a global community and as such has developers from all over the"},{"line_number":44,"context_line":"globe."},{"line_number":45,"context_line":"Interaction with the community means working and interacting with people from"},{"line_number":46,"context_line":"different timezones and cultures, as such there are other non-technical"},{"line_number":47,"context_line":"recommendations that help facilitate engagement in the OpenStack community,"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_adffc700","line":44,"in_reply_to":"3f79a3b5_53f382e7","updated":"2018-10-10 03:45:38.000000000","message":"Done","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"c494d6906371d384c6fc71dc35b9af6088b2390f","unresolved":false,"context_lines":[{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* Permission to occasionally work outside typical office hours"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"  * emailing, irc conversations, etc"},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"* Permission to agree to the OpenStack ICLA (required)"},{"line_number":55,"context_line":"* A process to clear contributions from IP point of view"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_73231e59","line":52,"updated":"2018-09-20 16:05:26.000000000","message":"Mentioning \"meetings\" here may make the argument stronger.","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"026125ba8fd2a0161f3c0d1d4159605cd40a9629","unresolved":false,"context_lines":[{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* Permission to occasionally work outside typical office hours"},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"  * emailing, irc conversations, etc"},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"* Permission to agree to the OpenStack ICLA (required)"},{"line_number":55,"context_line":"* A process to clear contributions from IP point of view"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_50fa4611","line":52,"in_reply_to":"3f79a3b5_73231e59","updated":"2018-10-10 03:45:38.000000000","message":"Done","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":15993,"name":"Amy Marrich","display_name":"Amy Marrich (spotz)","email":"amy@demarco.com","username":"amarrich"},"change_message_id":"e3852aca45dfd3b916bf8ff8f6e59b55efafd58c","unresolved":false,"context_lines":[{"line_number":77,"context_line":"  linked to titles"},{"line_number":78,"context_line":"* Forks are bad"},{"line_number":79,"context_line":""},{"line_number":80,"context_line":"  * citing articles about how maintaining forks is generally an expensive and"},{"line_number":81,"context_line":"    painful process (via links to further reading on effective open source"},{"line_number":82,"context_line":"    community involvement)"},{"line_number":83,"context_line":""},{"line_number":84,"context_line":"* Good metrics are hard https://en.wikipedia.org/wiki/Goodhart%27s_law"},{"line_number":85,"context_line":"* Focusing staff on particular project areas, or towards particular goals is"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_317a5777","line":82,"range":{"start_line":80,"start_character":0,"end_line":82,"end_character":26},"updated":"2018-09-10 16:26:25.000000000","message":"This reads a bit awkwardly Is this a speakers note?.","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":6088,"name":"Emmet Hikory","email":"persia@shipstone.jp","username":"persia"},"change_message_id":"cb21ea3c4bae78668ed1ab5fc4ff6474e7a15b9e","unresolved":false,"context_lines":[{"line_number":77,"context_line":"  linked to titles"},{"line_number":78,"context_line":"* Forks are bad"},{"line_number":79,"context_line":""},{"line_number":80,"context_line":"  * citing articles about how maintaining forks is generally an expensive and"},{"line_number":81,"context_line":"    painful process (via links to further reading on effective open source"},{"line_number":82,"context_line":"    community involvement)"},{"line_number":83,"context_line":""},{"line_number":84,"context_line":"* Good metrics are hard https://en.wikipedia.org/wiki/Goodhart%27s_law"},{"line_number":85,"context_line":"* Focusing staff on particular project areas, or towards particular goals is"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3f79a3b5_f60a5f1e","line":82,"range":{"start_line":80,"start_character":0,"end_line":82,"end_character":26},"in_reply_to":"3f79a3b5_317a5777","updated":"2018-09-12 17:10:49.000000000","message":"More of a todo item.  When we write prose about \"forks are bad\", as the audience is organisations, we intend to include discussion of the cost effects of forks, rather than just the social effects.","commit_id":"068eea30d3957e0e5495028c837421a0ace4969f"},{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"7bda4723313cae0454d49ed49d7ba8fbebb29d48","unresolved":false,"context_lines":[{"line_number":11,"context_line":"Recommendations"},{"line_number":12,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":13,"context_line":""},{"line_number":14,"context_line":"Developer Involvement"},{"line_number":15,"context_line":"---------------------"},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"Why we need to send technical people into the community?"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3f79a3b5_15d9ea54","line":14,"updated":"2018-10-10 03:55:57.000000000","message":"Here is a section for the questions rico lin wrotr in comments (Thanks!). We probably want to make these more concise. Use consistent terms throughout the doc etc.\n\nbut figure this is an iterative process, so putting them here means we can all review them easier.","commit_id":"e03de63a66338e0b9c910432847377b9a6b117e5"},{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"c0298989dff8045ce2f829d9f0cae9859146744f","unresolved":false,"context_lines":[{"line_number":11,"context_line":"Recommendations"},{"line_number":12,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":13,"context_line":""},{"line_number":14,"context_line":"Developer Involvement"},{"line_number":15,"context_line":"---------------------"},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"Why we need to send technical people into the community?"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3f79a3b5_eac7ac97","line":14,"in_reply_to":"3f79a3b5_07ff8166","updated":"2018-10-10 05:50:29.000000000","message":"ahh not a bad idea, we can always pull it out and add a patch to the chain. Assuming we want to land something. However, because we have the link (file 3) setup, then this lands it might become live so we\u0027d want at least a minimal version that we\u0027re happy with the world to see before we +A anything.","commit_id":"e03de63a66338e0b9c910432847377b9a6b117e5"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"b572cf8c9e208592965a4776465a66635ee8c7a2","unresolved":false,"context_lines":[{"line_number":11,"context_line":"Recommendations"},{"line_number":12,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":13,"context_line":""},{"line_number":14,"context_line":"Developer Involvement"},{"line_number":15,"context_line":"---------------------"},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"Why we need to send technical people into the community?"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3f79a3b5_07ff8166","line":14,"in_reply_to":"3f79a3b5_15d9ea54","updated":"2018-10-10 05:19:08.000000000","message":"This is nice. for better way we can make this section more heading section than paragraph. I was thinking to do this section as separate patch because this might require more discussion. \n\nAnd as first we get rest of the part in.","commit_id":"e03de63a66338e0b9c910432847377b9a6b117e5"},{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"7bda4723313cae0454d49ed49d7ba8fbebb29d48","unresolved":false,"context_lines":[{"line_number":88,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"Code"},{"line_number":91,"context_line":"^^^^"},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"* Access to review.openstack.org for code review and code submission."},{"line_number":94,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"3f79a3b5_f5c6ae69","line":91,"updated":"2018-10-10 03:55:57.000000000","message":"I\u0027ve had a go of breaking down the Technical section into more smaller headings so we can have \"suggestions\" on each one if we want.","commit_id":"e03de63a66338e0b9c910432847377b9a6b117e5"},{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"7bda4723313cae0454d49ed49d7ba8fbebb29d48","unresolved":false,"context_lines":[{"line_number":93,"context_line":"* Access to review.openstack.org for code review and code submission."},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"  * Port 29428/tcp is the Gerrit SSH API."},{"line_number":96,"context_line":"  * Port 443/tcp is also available to access gerrit (TODO confirm, find details maybe add them directly to the contributor guides gerrit secion)"},{"line_number":97,"context_line":"  * For more information on how we use gerrit see:"},{"line_number":98,"context_line":""},{"line_number":99,"context_line":"    * https://docs.openstack.org/contributors/common/setup-gerrit.html#what-is-gerrit"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3f79a3b5_f5dd4e3f","line":96,"updated":"2018-10-10 03:55:57.000000000","message":"@doug: so we can push code to gerrit via 443?\n\nWe can obviously use the UI which I guess is using gerrit on 443. I\u0027ve only ever used the 29428 port.","commit_id":"e03de63a66338e0b9c910432847377b9a6b117e5"},{"author":{"_account_id":5263,"name":"Jeremy Stanley","display_name":"fungi","email":"fungi@yuggoth.org","username":"fungi","status":"missing, presumed fed"},"change_message_id":"bef613353b73b26bc20ff8718df289a830b3f391","unresolved":false,"context_lines":[{"line_number":93,"context_line":"* Access to review.openstack.org for code review and code submission."},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"  * Port 29428/tcp is the Gerrit SSH API."},{"line_number":96,"context_line":"  * Port 443/tcp is also available to access gerrit (TODO confirm, find details maybe add them directly to the contributor guides gerrit secion)"},{"line_number":97,"context_line":"  * For more information on how we use gerrit see:"},{"line_number":98,"context_line":""},{"line_number":99,"context_line":"    * https://docs.openstack.org/contributors/common/setup-gerrit.html#what-is-gerrit"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3f79a3b5_069d386b","line":96,"updated":"2018-10-10 13:34:17.000000000","message":"I see using git/git-review over HTTPS with Gerrit as a workaround for situations where 29428/tcp isn\u0027t already open. It\u0027s less convenient since you need to deal with password management, and less secure for similar reasons. It *does* work though, yes.","commit_id":"e03de63a66338e0b9c910432847377b9a6b117e5"},{"author":{"_account_id":8482,"name":"Colleen Murphy","email":"colleen@gazlene.net","username":"krinkle"},"change_message_id":"3e8c319974a68181746e7b680687d156b0520c0c","unresolved":false,"context_lines":[{"line_number":93,"context_line":"* Access to review.openstack.org for code review and code submission."},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"  * Port 29428/tcp is the Gerrit SSH API."},{"line_number":96,"context_line":"  * Port 443/tcp is also available to access gerrit (TODO confirm, find details maybe add them directly to the contributor guides gerrit secion)"},{"line_number":97,"context_line":"  * For more information on how we use gerrit see:"},{"line_number":98,"context_line":""},{"line_number":99,"context_line":"    * https://docs.openstack.org/contributors/common/setup-gerrit.html#what-is-gerrit"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3f79a3b5_60ef3bb1","line":96,"in_reply_to":"3f79a3b5_f5dd4e3f","updated":"2018-10-10 07:31:06.000000000","message":"This is not about the GUI, you can use git review with HTTPS\n\nhttps://docs.openstack.org/infra/manual/developers.html#accessing-gerrit-over-https","commit_id":"e03de63a66338e0b9c910432847377b9a6b117e5"},{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"7bda4723313cae0454d49ed49d7ba8fbebb29d48","unresolved":false,"context_lines":[{"line_number":111,"context_line":"~~~~~~~~~~~"},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"There are browser based IRC services, like irccloud, that will keep users connected and"},{"line_number":114,"context_line":"use the standard HTTPS (443/tcp)"},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Email Consideration"},{"line_number":117,"context_line":"^^^^^^^^^^^^^^^^^^^"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3f79a3b5_15b24a07","line":114,"updated":"2018-10-10 03:55:57.000000000","message":"There has been talk in the past about potentially infra running a service like this to make it easier for devs to consume. (bit more slackish yet still IRC).\n\n/me loves IRC, so continuing using IRC would make me happy.","commit_id":"e03de63a66338e0b9c910432847377b9a6b117e5"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"b572cf8c9e208592965a4776465a66635ee8c7a2","unresolved":false,"context_lines":[{"line_number":99,"context_line":"    * https://docs.openstack.org/contributors/common/setup-gerrit.html#what-is-gerrit"},{"line_number":100,"context_line":"    * https://docs.openstack.org/contributors/code-and-documentation/using-gerrit.html"},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Internet Relay Chat (IRC)"},{"line_number":103,"context_line":"^^^^^^^^^^^^^^^^^^^^^^^^^"},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"* Access to chat.freenode.net port 6697/tcp (IRC communication)"},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"  * If utilizing an IRC bouncer port 443, to the bouncer, may be used."},{"line_number":108,"context_line":"  * See https://docs.openstack.org/contributors/common/communication.html#irc"},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"Suggestions"},{"line_number":111,"context_line":"~~~~~~~~~~~"},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"There are browser based IRC services, like irccloud, that will keep users connected and"},{"line_number":114,"context_line":"use the standard HTTPS (443/tcp)"},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Email Consideration"},{"line_number":117,"context_line":"^^^^^^^^^^^^^^^^^^^"},{"line_number":118,"context_line":"* Ability to receive E-mail from and send E-mail to addresses at"},{"line_number":119,"context_line":"  lists.openstack.org (mailing lists)"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3f79a3b5_a7c7ad46","line":116,"range":{"start_line":102,"start_character":0,"end_line":116,"end_character":19},"updated":"2018-10-10 05:19:08.000000000","message":"we can make these into single section - \u0027communication\u0027. come thing like below- \n\nTechnical\n---------\nCode\nCommunication\n - Internet Relay Chat (IRC)\n - Email\nOperating System (OS) Considerations\n\nbut we can do this in follow up.","commit_id":"e03de63a66338e0b9c910432847377b9a6b117e5"},{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"c0298989dff8045ce2f829d9f0cae9859146744f","unresolved":false,"context_lines":[{"line_number":99,"context_line":"    * https://docs.openstack.org/contributors/common/setup-gerrit.html#what-is-gerrit"},{"line_number":100,"context_line":"    * https://docs.openstack.org/contributors/code-and-documentation/using-gerrit.html"},{"line_number":101,"context_line":""},{"line_number":102,"context_line":"Internet Relay Chat (IRC)"},{"line_number":103,"context_line":"^^^^^^^^^^^^^^^^^^^^^^^^^"},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"* Access to chat.freenode.net port 6697/tcp (IRC communication)"},{"line_number":106,"context_line":""},{"line_number":107,"context_line":"  * If utilizing an IRC bouncer port 443, to the bouncer, may be used."},{"line_number":108,"context_line":"  * See https://docs.openstack.org/contributors/common/communication.html#irc"},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"Suggestions"},{"line_number":111,"context_line":"~~~~~~~~~~~"},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"There are browser based IRC services, like irccloud, that will keep users connected and"},{"line_number":114,"context_line":"use the standard HTTPS (443/tcp)"},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Email Consideration"},{"line_number":117,"context_line":"^^^^^^^^^^^^^^^^^^^"},{"line_number":118,"context_line":"* Ability to receive E-mail from and send E-mail to addresses at"},{"line_number":119,"context_line":"  lists.openstack.org (mailing lists)"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3f79a3b5_ca41900a","line":116,"range":{"start_line":102,"start_character":0,"end_line":116,"end_character":19},"in_reply_to":"3f79a3b5_a7c7ad46","updated":"2018-10-10 05:50:29.000000000","message":"Nice yeah. I like that.\n\nI originally started writing it that way. Though wanted to be able to add the \"suggestions\" sections if we had some optional suggestions. And didn\u0027t know how people felt about having too many heading levels.\n\nBut can play with that.","commit_id":"e03de63a66338e0b9c910432847377b9a6b117e5"},{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"7bda4723313cae0454d49ed49d7ba8fbebb29d48","unresolved":false,"context_lines":[{"line_number":135,"context_line":"  hardware."},{"line_number":136,"context_line":""},{"line_number":137,"context_line":"Non-Technical"},{"line_number":138,"context_line":"-------------"},{"line_number":139,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":140,"context_line":""},{"line_number":141,"context_line":"OpenStack is a global community. Interaction with the community means working"}],"source_content_type":"text/x-rst","patch_set":4,"id":"3f79a3b5_35b506ee","line":138,"updated":"2018-10-10 03:55:57.000000000","message":"I\u0027ve still yet to rework the doc below here.","commit_id":"e03de63a66338e0b9c910432847377b9a6b117e5"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"68cf9808b2d40908ea6cc628d27a657ddf2e2e97","unresolved":false,"context_lines":[{"line_number":39,"context_line":""},{"line_number":40,"context_line":"* Monitor the health of the project."},{"line_number":41,"context_line":"* Be involved in design and direction of the project."},{"line_number":42,"context_line":"* Being involved in discussions."},{"line_number":43,"context_line":"* Don\u0027t have to carry downstream patches."},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"The more people you give, the better attention your feature will get. Providing"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f79a3b5_b8a58303","line":42,"range":{"start_line":42,"start_character":2,"end_line":42,"end_character":20},"updated":"2018-10-10 12:24:14.000000000","message":"Suggest: Be involved in and shape implementation discussions.","commit_id":"4841e4fcd60582178b89de6a0c917272d29664d5"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"68cf9808b2d40908ea6cc628d27a657ddf2e2e97","unresolved":false,"context_lines":[{"line_number":40,"context_line":"* Monitor the health of the project."},{"line_number":41,"context_line":"* Be involved in design and direction of the project."},{"line_number":42,"context_line":"* Being involved in discussions."},{"line_number":43,"context_line":"* Don\u0027t have to carry downstream patches."},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"The more people you give, the better attention your feature will get. Providing"},{"line_number":46,"context_line":"more reviewers will definitely help merge your implementation to projects."}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f79a3b5_585f8f0e","line":43,"range":{"start_line":43,"start_character":2,"end_line":43,"end_character":21},"updated":"2018-10-10 12:24:14.000000000","message":"Suggest: Avoid carrying downstream patches.","commit_id":"4841e4fcd60582178b89de6a0c917272d29664d5"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"68cf9808b2d40908ea6cc628d27a657ddf2e2e97","unresolved":false,"context_lines":[{"line_number":42,"context_line":"* Being involved in discussions."},{"line_number":43,"context_line":"* Don\u0027t have to carry downstream patches."},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"The more people you give, the better attention your feature will get. Providing"},{"line_number":46,"context_line":"more reviewers will definitely help merge your implementation to projects."},{"line_number":47,"context_line":"Code review is a bottleneck for landing patches, more good reviews the faster"},{"line_number":48,"context_line":"code can land."}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f79a3b5_588d4f7a","line":45,"range":{"start_line":45,"start_character":20,"end_line":45,"end_character":24},"updated":"2018-10-10 12:24:14.000000000","message":"Suggest: have working upstream","commit_id":"4841e4fcd60582178b89de6a0c917272d29664d5"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"68cf9808b2d40908ea6cc628d27a657ddf2e2e97","unresolved":false,"context_lines":[{"line_number":53,"context_line":"The ideal answer is to give the technical people as much percentage of their"},{"line_number":54,"context_line":"time you can give, and for as long as possible."},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"If your large enough to have the choice. Giving engineers more time"},{"line_number":57,"context_line":"specialising, or concentrating, on a specific domain tends to be more"},{"line_number":58,"context_line":"efficient then having engineers continually context switching as they have to"},{"line_number":59,"context_line":"wear multiple hats."},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"Having engineers spending more time upstream helps everyone by providing"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f79a3b5_f83f7b83","line":58,"range":{"start_line":56,"start_character":3,"end_line":58,"end_character":14},"updated":"2018-10-10 12:24:14.000000000","message":"Suggest: your company is large enough to have the choice, giving engineers more time to specialise and concentrate on specific areas tend to be more efficient than","commit_id":"4841e4fcd60582178b89de6a0c917272d29664d5"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"68cf9808b2d40908ea6cc628d27a657ddf2e2e97","unresolved":false,"context_lines":[{"line_number":59,"context_line":"wear multiple hats."},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"Having engineers spending more time upstream helps everyone by providing"},{"line_number":62,"context_line":"continuous input and feedback to tasks that you set as high priority."},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"Why you need to sync with the technical community?"},{"line_number":65,"context_line":"^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f79a3b5_58feafaf","line":62,"updated":"2018-10-10 12:24:14.000000000","message":"Might want to mention something about how being in the community long term also keeps the company ahead of the curve because they are embedded in what\u0027s happening rather than popping in and out.","commit_id":"4841e4fcd60582178b89de6a0c917272d29664d5"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"68cf9808b2d40908ea6cc628d27a657ddf2e2e97","unresolved":false,"context_lines":[{"line_number":70,"context_line":""},{"line_number":71,"context_line":"Better yet, instead of forking or adding downstream"},{"line_number":72,"context_line":"patches in your own products that you need to carry and maintain, which can"},{"line_number":73,"context_line":"be very costly. You could get it upstream and get many other developers"},{"line_number":74,"context_line":"improving and maintaining it with you. Now the additional cost and risk of"},{"line_number":75,"context_line":"maintaining it and applying the patch or feature has gone."},{"line_number":76,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f79a3b5_18cfd78b","line":73,"updated":"2018-10-10 12:24:14.000000000","message":"and often end up breaking entirely.","commit_id":"4841e4fcd60582178b89de6a0c917272d29664d5"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"68cf9808b2d40908ea6cc628d27a657ddf2e2e97","unresolved":false,"context_lines":[{"line_number":70,"context_line":""},{"line_number":71,"context_line":"Better yet, instead of forking or adding downstream"},{"line_number":72,"context_line":"patches in your own products that you need to carry and maintain, which can"},{"line_number":73,"context_line":"be very costly. You could get it upstream and get many other developers"},{"line_number":74,"context_line":"improving and maintaining it with you. Now the additional cost and risk of"},{"line_number":75,"context_line":"maintaining it and applying the patch or feature has gone."},{"line_number":76,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f79a3b5_f8dbfb4a","line":73,"range":{"start_line":73,"start_character":46,"end_line":73,"end_character":61},"updated":"2018-10-10 12:24:14.000000000","message":"benefit from an entire community of developers","commit_id":"4841e4fcd60582178b89de6a0c917272d29664d5"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"68cf9808b2d40908ea6cc628d27a657ddf2e2e97","unresolved":false,"context_lines":[{"line_number":72,"context_line":"patches in your own products that you need to carry and maintain, which can"},{"line_number":73,"context_line":"be very costly. You could get it upstream and get many other developers"},{"line_number":74,"context_line":"improving and maintaining it with you. Now the additional cost and risk of"},{"line_number":75,"context_line":"maintaining it and applying the patch or feature has gone."},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"(NOTE: We planned on adding references to why forking is bad later in the DOC"},{"line_number":78,"context_line":"So maybe we don\u0027t need to talk about it here?)"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f79a3b5_98cbe771","line":75,"updated":"2018-10-10 12:24:14.000000000","message":"It will also be better tested than anything developed internally because it will be tested by the community and used more widely than just your customers.","commit_id":"4841e4fcd60582178b89de6a0c917272d29664d5"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"68cf9808b2d40908ea6cc628d27a657ddf2e2e97","unresolved":false,"context_lines":[{"line_number":74,"context_line":"improving and maintaining it with you. Now the additional cost and risk of"},{"line_number":75,"context_line":"maintaining it and applying the patch or feature has gone."},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"(NOTE: We planned on adding references to why forking is bad later in the DOC"},{"line_number":78,"context_line":"So maybe we don\u0027t need to talk about it here?)"},{"line_number":79,"context_line":""},{"line_number":80,"context_line":"You also get the benefit of other eyes on code, and even benefit from the"},{"line_number":81,"context_line":"experience of others. As well as having many more developers helping in the"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f79a3b5_78c04b4b","line":78,"range":{"start_line":77,"start_character":77,"end_line":78,"end_character":46},"updated":"2018-10-10 12:24:14.000000000","message":"Yeah I think if its mentioned further down, it doesn\u0027t need to be covered here as well.","commit_id":"4841e4fcd60582178b89de6a0c917272d29664d5"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"68cf9808b2d40908ea6cc628d27a657ddf2e2e97","unresolved":false,"context_lines":[{"line_number":165,"context_line":"Community Culture (or education?)"},{"line_number":166,"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"},{"line_number":167,"context_line":""},{"line_number":168,"context_line":"NOTE: maybe this section should live under recommendations as well?"},{"line_number":169,"context_line":""},{"line_number":170,"context_line":"TODO: We need to work on (from etherpad)"},{"line_number":171,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"3f79a3b5_589a2f6f","line":168,"updated":"2018-10-10 12:24:14.000000000","message":"I feel like its a subset of Non-Technical. Maybe we have a communication subsection, a culture subsection, and an expectations subsection?","commit_id":"4841e4fcd60582178b89de6a0c917272d29664d5"},{"author":{"_account_id":12404,"name":"Rico Lin","email":"ricolin@ricolky.com","username":"rico.lin"},"change_message_id":"0f084db9d598f96c3051a41d4449078bf674393a","unresolved":false,"context_lines":[{"line_number":51,"context_line":"^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^"},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"The ideal answer is to give the technical people as much percentage of their"},{"line_number":54,"context_line":"time you can give, and for as long as possible."},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"If your company is large enough to have the choice, giving engineers more time"},{"line_number":57,"context_line":"to specialise and concentrate on specific areas tend to be more efficient than"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3f79a3b5_4b57a6f6","line":54,"range":{"start_line":54,"start_character":4,"end_line":54,"end_character":5},"updated":"2018-11-06 08:44:29.000000000","message":"as you can give","commit_id":"ce715d1f31b0fe1b7899895848cdbb28faa8e531"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"858fcbd18c21805e115c79056158a81c75c4bf5d","unresolved":false,"context_lines":[{"line_number":59,"context_line":"wear multiple hats."},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"Having engineers spending more time upstream helps everyone by providing"},{"line_number":62,"context_line":"continuous input and feedback to tasks that you set as high priority."},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"Further, having engineers in the community long term will also keep the"},{"line_number":65,"context_line":"company ahead of the curve as they are embedded and engaged in the community"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3f79a3b5_553e5bb6","line":62,"updated":"2018-11-06 13:02:17.000000000","message":"We should emphasize here that the reason they need plenty of time to work upstream is that we rely on peer review, and therefore need people to *do* those reviews.","commit_id":"ce715d1f31b0fe1b7899895848cdbb28faa8e531"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"858fcbd18c21805e115c79056158a81c75c4bf5d","unresolved":false,"context_lines":[{"line_number":63,"context_line":""},{"line_number":64,"context_line":"Further, having engineers in the community long term will also keep the"},{"line_number":65,"context_line":"company ahead of the curve as they are embedded and engaged in the community"},{"line_number":66,"context_line":"rather then popping in and out."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"Why you need to sync with the technical community?"},{"line_number":69,"context_line":"^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3f79a3b5_f5952795","line":66,"updated":"2018-11-06 13:02:17.000000000","message":"We should also say that the more invested they are in the community, the more likely they are to earn a place that gives them influence.","commit_id":"ce715d1f31b0fe1b7899895848cdbb28faa8e531"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"728f4b7a9ded314c0b4b54fb04fcc6644a56a5da","unresolved":false,"context_lines":[{"line_number":120,"context_line":"Suggestions"},{"line_number":121,"context_line":"~~~~~~~~~~~"},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"There are browser based IRC services, like irccloud, that will keep users"},{"line_number":124,"context_line":"connected and use the standard HTTPS (443/tcp)"},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Email Consideration"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3f79a3b5_b9e573a5","line":123,"range":{"start_line":123,"start_character":0,"end_line":123,"end_character":17},"updated":"2018-11-06 07:48:03.000000000","message":"Shouldn\u0027t we also suggest the usage of a Socks server for both Gerrit and IRC?","commit_id":"ce715d1f31b0fe1b7899895848cdbb28faa8e531"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"858fcbd18c21805e115c79056158a81c75c4bf5d","unresolved":false,"context_lines":[{"line_number":120,"context_line":"Suggestions"},{"line_number":121,"context_line":"~~~~~~~~~~~"},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"There are browser based IRC services, like irccloud, that will keep users"},{"line_number":124,"context_line":"connected and use the standard HTTPS (443/tcp)"},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Email Consideration"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3f79a3b5_d53cab92","line":123,"range":{"start_line":123,"start_character":0,"end_line":123,"end_character":17},"in_reply_to":"3f79a3b5_b9e573a5","updated":"2018-11-06 13:02:17.000000000","message":"Is Socks a requirement? Or is it an option that solves a connectivity problem?","commit_id":"ce715d1f31b0fe1b7899895848cdbb28faa8e531"},{"author":{"_account_id":21723,"name":"Gergely Csatari","email":"gergely.csatari@nokia.com","username":"csatari"},"change_message_id":"e836d5ec8c911b54922992eea756e9fbf2abb382","unresolved":false,"context_lines":[{"line_number":120,"context_line":"Suggestions"},{"line_number":121,"context_line":"~~~~~~~~~~~"},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"There are browser based IRC services, like irccloud, that will keep users"},{"line_number":124,"context_line":"connected and use the standard HTTPS (443/tcp)"},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Email Consideration"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3f79a3b5_d00a79ce","line":123,"range":{"start_line":123,"start_character":0,"end_line":123,"end_character":17},"in_reply_to":"3f79a3b5_d53cab92","updated":"2018-11-06 13:47:11.000000000","message":"It is an option that solves connectivity problem.","commit_id":"ce715d1f31b0fe1b7899895848cdbb28faa8e531"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"1f18f125c81cef34f0af0794fee83d2e1a166bb8","unresolved":false,"context_lines":[{"line_number":143,"context_line":""},{"line_number":144,"context_line":"* Permission to run Linux and install other open source software on"},{"line_number":145,"context_line":"  employer-supplied hardware."},{"line_number":146,"context_line":""},{"line_number":147,"context_line":"Non-Technical"},{"line_number":148,"context_line":"-------------"},{"line_number":149,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"3f79a3b5_5eac4535","line":146,"range":{"start_line":146,"start_character":0,"end_line":146,"end_character":0},"updated":"2018-11-06 06:49:06.000000000","message":"we can add about sending key people to openstack Technical events like PTG etc.\n\nBut let\u0027s get this version in and add that later if looks ok.","commit_id":"ce715d1f31b0fe1b7899895848cdbb28faa8e531"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"858fcbd18c21805e115c79056158a81c75c4bf5d","unresolved":false,"context_lines":[{"line_number":151,"context_line":"and interacting with people from different timezones and cultures, as such"},{"line_number":152,"context_line":"there are other non-technical recommendations that help"},{"line_number":153,"context_line":"facilitate engagement in the OpenStack community, these can be broken down into"},{"line_number":154,"context_line":"3 areas, communication, culture and expectations"},{"line_number":155,"context_line":""},{"line_number":156,"context_line":"Communication"},{"line_number":157,"context_line":"^^^^^^^^^^^^^"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3f79a3b5_1560e3a3","line":154,"range":{"start_line":154,"start_character":7,"end_line":154,"end_character":8},"updated":"2018-11-06 13:02:17.000000000","message":"s/,/:/","commit_id":"ce715d1f31b0fe1b7899895848cdbb28faa8e531"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"858fcbd18c21805e115c79056158a81c75c4bf5d","unresolved":false,"context_lines":[{"line_number":196,"context_line":"    communication system to make feature/project decisions, make sure you make"},{"line_number":197,"context_line":"    it possible for asynchronous input from members in other timezones."},{"line_number":198,"context_line":"  * Different timezones means different cultures, so be sensitive to"},{"line_number":199,"context_line":"    these cultural differences. One example is to give non native english"},{"line_number":200,"context_line":"    speakers a chance to think and speak and if using a voice medium, please"},{"line_number":201,"context_line":"    slow down."},{"line_number":202,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"3f79a3b5_150543c1","line":199,"range":{"start_line":199,"start_character":58,"end_line":199,"end_character":59},"updated":"2018-11-06 13:02:17.000000000","message":"s/ /-/","commit_id":"ce715d1f31b0fe1b7899895848cdbb28faa8e531"}],"doc/source/index.rst":[{"author":{"_account_id":7233,"name":"Matthew Oliver","email":"matt@oliver.net.au","username":"mattoliverau"},"change_message_id":"37caf54df74892ddcf7c91d19a5cd0ed8b85e12f","unresolved":false,"context_lines":[{"line_number":15,"context_line":"   users/index"},{"line_number":16,"context_line":"   operators/index"},{"line_number":17,"context_line":"   contributing/index"},{"line_number":18,"context_line":"   contributing/organization-guide"},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"Search in this guide"},{"line_number":21,"context_line":"--------------------"}],"source_content_type":"text/x-rst","patch_set":8,"id":"3f79a3b5_aebf4fc9","line":18,"updated":"2018-11-07 07:12:29.000000000","message":"Put it above contributing/index","commit_id":"ce715d1f31b0fe1b7899895848cdbb28faa8e531"}]}