)]}'
{"goals/proposed/project-ptl-and-contrib-docs.rst":[{"author":{"_account_id":8482,"name":"Colleen Murphy","email":"colleen@gazlene.net","username":"krinkle"},"change_message_id":"5a9b537a30b6a5019a940022886e08feb55f9d07","unresolved":false,"context_lines":[{"line_number":13,"context_line":"to cycle or during a cycle when unforeseen circumstances arise."},{"line_number":14,"context_line":"Having this information documented would also help with"},{"line_number":15,"context_line":"transparency for current contributors working towards the role"},{"line_number":16,"context_line":"themselves because there would be no question about what"},{"line_number":17,"context_line":"the job entails."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"Similarly to how PTLs of different projects have different duties,"},{"line_number":20,"context_line":"the projects have different processes. While the general"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_b28aa017","line":17,"range":{"start_line":16,"start_character":11,"end_line":17,"end_character":16},"updated":"2019-11-12 03:11:57.000000000","message":"We often talk about trying to make the PTL role less daunting and less time-consuming, so this part of the goal strikes me as somewhat paradoxical because it\u0027s adding on another task for the PTL to do. Yes, ex-PTLs can also help with this, but many of them leave the community after handing over the PTL role, and still the number of people who can contribute to this *community* goal is a fraction of the community. It seems to me that instead of making this a community goal, you could just ask the PTLs directly to do this. Then the overall completion rate of the contributor documentation goal won\u0027t be dependent on a select few individuals.","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"de8e4a87821fc858c5d6c7e50d4075b5f89e3732","unresolved":false,"context_lines":[{"line_number":13,"context_line":"to cycle or during a cycle when unforeseen circumstances arise."},{"line_number":14,"context_line":"Having this information documented would also help with"},{"line_number":15,"context_line":"transparency for current contributors working towards the role"},{"line_number":16,"context_line":"themselves because there would be no question about what"},{"line_number":17,"context_line":"the job entails."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"Similarly to how PTLs of different projects have different duties,"},{"line_number":20,"context_line":"the projects have different processes. While the general"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_8df8544a","line":17,"range":{"start_line":16,"start_character":11,"end_line":17,"end_character":16},"in_reply_to":"3fa7e38b_b28aa017","updated":"2019-11-18 19:57:22.000000000","message":"I think I\u0027m fine with this. I would still include the PTL section in the contributing.rst but maybe we could say that it doesn\u0027t need to be complete to finish the goal?","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":11975,"name":"Slawek Kaplonski","email":"skaplons@redhat.com","username":"slaweq"},"change_message_id":"f4585f7de82a2bcc82c50e99461d4694f3570bff","unresolved":false,"context_lines":[{"line_number":22,"context_line":"provided in a variety of places like `the Contributor"},{"line_number":23,"context_line":"Guide \u003chttps://docs.openstack.org/contributors/code-and-documentation/index.html\u003e`_ ,"},{"line_number":24,"context_line":"there are a lot of project specific details that aren\u0027t documented."},{"line_number":25,"context_line":"Does X project require blueprints or are specifications enough?"},{"line_number":26,"context_line":"Does Y project require one or two plus twos to merge? These"},{"line_number":27,"context_line":"project specific details should be documented in the projects\u0027"},{"line_number":28,"context_line":"own contributor guides. Having all this information in a single"},{"line_number":29,"context_line":"place will lower the barrier to entry for new contributors. "}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_513895d1","line":26,"range":{"start_line":25,"start_character":0,"end_line":26,"end_character":53},"updated":"2019-10-30 08:53:22.000000000","message":"Does Z project use Storyboard or Launchpad as a bug tracker?","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":13995,"name":"Nate Johnston","email":"nate.johnston@redhat.com","username":"natejohnston"},"change_message_id":"2d5e1c0308c58ebd2d0b59eefce69c7f29d3edcf","unresolved":false,"context_lines":[{"line_number":22,"context_line":"provided in a variety of places like `the Contributor"},{"line_number":23,"context_line":"Guide \u003chttps://docs.openstack.org/contributors/code-and-documentation/index.html\u003e`_ ,"},{"line_number":24,"context_line":"there are a lot of project specific details that aren\u0027t documented."},{"line_number":25,"context_line":"Does X project require blueprints or are specifications enough?"},{"line_number":26,"context_line":"Does Y project require one or two plus twos to merge? These"},{"line_number":27,"context_line":"project specific details should be documented in the projects\u0027"},{"line_number":28,"context_line":"own contributor guides. Having all this information in a single"},{"line_number":29,"context_line":"place will lower the barrier to entry for new contributors. "}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_a54bc384","line":26,"range":{"start_line":25,"start_character":0,"end_line":26,"end_character":53},"in_reply_to":"3fa7e38b_513895d1","updated":"2019-10-30 14:07:19.000000000","message":"+1","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"de8e4a87821fc858c5d6c7e50d4075b5f89e3732","unresolved":false,"context_lines":[{"line_number":22,"context_line":"provided in a variety of places like `the Contributor"},{"line_number":23,"context_line":"Guide \u003chttps://docs.openstack.org/contributors/code-and-documentation/index.html\u003e`_ ,"},{"line_number":24,"context_line":"there are a lot of project specific details that aren\u0027t documented."},{"line_number":25,"context_line":"Does X project require blueprints or are specifications enough?"},{"line_number":26,"context_line":"Does Y project require one or two plus twos to merge? These"},{"line_number":27,"context_line":"project specific details should be documented in the projects\u0027"},{"line_number":28,"context_line":"own contributor guides. Having all this information in a single"},{"line_number":29,"context_line":"place will lower the barrier to entry for new contributors. "}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_cd872cb6","line":26,"range":{"start_line":25,"start_character":0,"end_line":26,"end_character":53},"in_reply_to":"3fa7e38b_a54bc384","updated":"2019-11-18 19:57:22.000000000","message":"Agreed! Am open to other suggestions too. I am currently working on the template for contributing.rst and will push it as a patch to the cookiecutter repo so that any new projects also get the template. I discussed where the template should live with the docs team at the PTG, and they said the cookiecutter repo would be the most logical place.","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":11975,"name":"Slawek Kaplonski","email":"skaplons@redhat.com","username":"slaweq"},"change_message_id":"f4585f7de82a2bcc82c50e99461d4694f3570bff","unresolved":false,"context_lines":[{"line_number":26,"context_line":"Does Y project require one or two plus twos to merge? These"},{"line_number":27,"context_line":"project specific details should be documented in the projects\u0027"},{"line_number":28,"context_line":"own contributor guides. Having all this information in a single"},{"line_number":29,"context_line":"place will lower the barrier to entry for new contributors. "},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"Champion"},{"line_number":32,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_112e9d8b","line":29,"range":{"start_line":29,"start_character":59,"end_line":29,"end_character":60},"updated":"2019-10-30 08:53:22.000000000","message":"nitty nit: if You would respin this, please remove this trailing space maybe :) And also some other below too :)","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"de8e4a87821fc858c5d6c7e50d4075b5f89e3732","unresolved":false,"context_lines":[{"line_number":26,"context_line":"Does Y project require one or two plus twos to merge? These"},{"line_number":27,"context_line":"project specific details should be documented in the projects\u0027"},{"line_number":28,"context_line":"own contributor guides. Having all this information in a single"},{"line_number":29,"context_line":"place will lower the barrier to entry for new contributors. "},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"Champion"},{"line_number":32,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_ed8468b3","line":29,"range":{"start_line":29,"start_character":59,"end_line":29,"end_character":60},"in_reply_to":"3fa7e38b_112e9d8b","updated":"2019-11-18 19:57:22.000000000","message":"Will clean that up in the next patchset.","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":11975,"name":"Slawek Kaplonski","email":"skaplons@redhat.com","username":"slaweq"},"change_message_id":"f4585f7de82a2bcc82c50e99461d4694f3570bff","unresolved":false,"context_lines":[{"line_number":41,"context_line":""},{"line_number":42,"context_line":"  project-ptl-and-contrib-docs"},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"Completion Criteria"},{"line_number":45,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"#. There exists a PTL specific guide in each project\u0027s docs with"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_f1b3c14c","line":44,"updated":"2019-10-30 08:53:22.000000000","message":"I wonder if the part of this goal could be also do write some similar guide about TC member duties. Or maybe there is already something like that somewhere?","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"d42458399f16c5cf671b9ed45d011e3c8f4ae4d4","unresolved":false,"context_lines":[{"line_number":41,"context_line":""},{"line_number":42,"context_line":"  project-ptl-and-contrib-docs"},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"Completion Criteria"},{"line_number":45,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"#. There exists a PTL specific guide in each project\u0027s docs with"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_87a156ab","line":44,"in_reply_to":"3fa7e38b_057977c3","updated":"2019-11-13 06:58:24.000000000","message":"Well that doesn\u0027t explain what the TC does in a cycle, but merely what people do when joining. But let\u0027s not sidetrack here :)","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":13995,"name":"Nate Johnston","email":"nate.johnston@redhat.com","username":"natejohnston"},"change_message_id":"2d5e1c0308c58ebd2d0b59eefce69c7f29d3edcf","unresolved":false,"context_lines":[{"line_number":41,"context_line":""},{"line_number":42,"context_line":"  project-ptl-and-contrib-docs"},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"Completion Criteria"},{"line_number":45,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"#. There exists a PTL specific guide in each project\u0027s docs with"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_057977c3","line":44,"in_reply_to":"3fa7e38b_f1b3c14c","updated":"2019-10-30 14:07:19.000000000","message":"We actually just added one: https://governance.openstack.org/tc/reference/joining-tc.html","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"eb2a72bb8684ba31ccf4860ef64f5cba148c2597","unresolved":false,"context_lines":[{"line_number":44,"context_line":"Completion Criteria"},{"line_number":45,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"#. There exists a PTL specific guide in each project\u0027s docs with"},{"line_number":48,"context_line":"   all extra duties they perform beyond the common set enumerated"},{"line_number":49,"context_line":"   in the project team guide in the becoming a PTL section."},{"line_number":50,"context_line":"#. There exists a section of project specific information about"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_b148858a","line":47,"range":{"start_line":47,"start_character":3,"end_line":47,"end_character":7},"updated":"2019-11-07 11:03:59.000000000","message":"I think we\u0027re going to need to specify who needs to own this per-project. We asked for volunteers for the PDF goal, and that worked in the end, but it would be good to have guidelines of who can help. Maybe include a suggestion \"Ex-PTLs or current can help create...\" I dunno. Maybe thinking too far ahead.","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":13995,"name":"Nate Johnston","email":"nate.johnston@redhat.com","username":"natejohnston"},"change_message_id":"2301ab72c4d02f5d8836dedea78fd2a4c5c6cdb4","unresolved":false,"context_lines":[{"line_number":47,"context_line":"#. There exists a PTL specific guide in each project\u0027s docs with"},{"line_number":48,"context_line":"   all extra duties they perform beyond the common set enumerated"},{"line_number":49,"context_line":"   in the project team guide in the becoming a PTL section."},{"line_number":50,"context_line":"#. There exists a section of project specific information about"},{"line_number":51,"context_line":"   contribution to that project in each project\u0027s documentation."},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"Stretch goals"},{"line_number":54,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_dce35804","line":51,"range":{"start_line":50,"start_character":0,"end_line":51,"end_character":64},"updated":"2019-10-28 19:48:21.000000000","message":"You say that the information is specific to the project twice in this one sentence, which makes it awkward to read.  I would rephrase it more clearly to say \"In the project documentation there is a section or page that details how to contribute.\"","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"eb2a72bb8684ba31ccf4860ef64f5cba148c2597","unresolved":false,"context_lines":[{"line_number":47,"context_line":"#. There exists a PTL specific guide in each project\u0027s docs with"},{"line_number":48,"context_line":"   all extra duties they perform beyond the common set enumerated"},{"line_number":49,"context_line":"   in the project team guide in the becoming a PTL section."},{"line_number":50,"context_line":"#. There exists a section of project specific information about"},{"line_number":51,"context_line":"   contribution to that project in each project\u0027s documentation."},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"Stretch goals"},{"line_number":54,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_f1a7dd4f","line":51,"range":{"start_line":50,"start_character":0,"end_line":51,"end_character":64},"in_reply_to":"3fa7e38b_dce35804","updated":"2019-11-07 11:03:59.000000000","message":"Maybe also worth having is \"The project-specific PTL guide is linked directly to https://docs.openstack.org/project-team-guide/ptl.html for a central search location\"\n\nWe want this to be as accessible as possible. This can simply be linked, or we can do something similar to how we setup the deployment guides? that might be too much work for a minimum barrier to entry.\n\nAlso, linking means that the author doesn\u0027t have to repeat any information already existing in this section","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"de8e4a87821fc858c5d6c7e50d4075b5f89e3732","unresolved":false,"context_lines":[{"line_number":47,"context_line":"#. There exists a PTL specific guide in each project\u0027s docs with"},{"line_number":48,"context_line":"   all extra duties they perform beyond the common set enumerated"},{"line_number":49,"context_line":"   in the project team guide in the becoming a PTL section."},{"line_number":50,"context_line":"#. There exists a section of project specific information about"},{"line_number":51,"context_line":"   contribution to that project in each project\u0027s documentation."},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"Stretch goals"},{"line_number":54,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_6d507833","line":51,"range":{"start_line":50,"start_character":0,"end_line":51,"end_character":64},"in_reply_to":"3fa7e38b_f1a7dd4f","updated":"2019-11-18 19:57:22.000000000","message":"I was thinking the details would just live in the same contributing.rst file, but we could also link from the ptl doc in the project team guide to all the sections or we could just add a blurb saying where the info lives instead of linking to all of them?","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"eb2a72bb8684ba31ccf4860ef64f5cba148c2597","unresolved":false,"context_lines":[{"line_number":50,"context_line":"#. There exists a section of project specific information about"},{"line_number":51,"context_line":"   contribution to that project in each project\u0027s documentation."},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"Stretch goals"},{"line_number":54,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"I honestly can\u0027t think of any so I am open to ideas. Leaving the list"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_b15f254c","line":53,"range":{"start_line":53,"start_character":0,"end_line":53,"end_character":13},"updated":"2019-11-07 11:03:59.000000000","message":"I think this can probably be removed. The goal itself is quite large.\nBut if you want to include something, maybe \"A maintenance schedule for the outgoing team PTL to review and update if necessary\"","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"de8e4a87821fc858c5d6c7e50d4075b5f89e3732","unresolved":false,"context_lines":[{"line_number":50,"context_line":"#. There exists a section of project specific information about"},{"line_number":51,"context_line":"   contribution to that project in each project\u0027s documentation."},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"Stretch goals"},{"line_number":54,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"I honestly can\u0027t think of any so I am open to ideas. Leaving the list"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_0d36a403","line":53,"range":{"start_line":53,"start_character":0,"end_line":53,"end_character":13},"in_reply_to":"3fa7e38b_b15f254c","updated":"2019-11-18 19:57:22.000000000","message":"I can just remove it in the next patchset :)","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":13995,"name":"Nate Johnston","email":"nate.johnston@redhat.com","username":"natejohnston"},"change_message_id":"2301ab72c4d02f5d8836dedea78fd2a4c5c6cdb4","unresolved":false,"context_lines":[{"line_number":53,"context_line":"Stretch goals"},{"line_number":54,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"I honestly can\u0027t think of any so I am open to ideas. Leaving the list"},{"line_number":57,"context_line":"below blank for now."},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"#."},{"line_number":60,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_fca654c0","line":57,"range":{"start_line":56,"start_character":0,"end_line":57,"end_character":20},"updated":"2019-10-28 19:48:21.000000000","message":"Many of the things PTLs do may be passed down through oral tradition or custom.   There exists an opportunity PTLs to learn from each other\u0027s practices and perhaps learn novel or improved approaches to their problems.  Taking the best of the project-specific PTL information and uplifting it to the general PTL documentation could help spread best practices.","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"eb2a72bb8684ba31ccf4860ef64f5cba148c2597","unresolved":false,"context_lines":[{"line_number":62,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"* `Becoming a PTL Guide \u003chttps://docs.openstack.org/project-team-guide/ptl.html\u003e`_"},{"line_number":65,"context_line":"  "},{"line_number":66,"context_line":"* `Contributor  Guide \u003chttps://docs.openstack.org/contributors/code-and-documentation/index.html\u003e`_"},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"Current State / Anticipated Impact"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_d1642124","line":65,"range":{"start_line":65,"start_character":0,"end_line":65,"end_character":2},"updated":"2019-11-07 11:03:59.000000000","message":"just whitespace :)","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"de8e4a87821fc858c5d6c7e50d4075b5f89e3732","unresolved":false,"context_lines":[{"line_number":62,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":63,"context_line":""},{"line_number":64,"context_line":"* `Becoming a PTL Guide \u003chttps://docs.openstack.org/project-team-guide/ptl.html\u003e`_"},{"line_number":65,"context_line":"  "},{"line_number":66,"context_line":"* `Contributor  Guide \u003chttps://docs.openstack.org/contributors/code-and-documentation/index.html\u003e`_"},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"Current State / Anticipated Impact"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_b0b00342","line":65,"range":{"start_line":65,"start_character":0,"end_line":65,"end_character":2},"in_reply_to":"3fa7e38b_d1642124","updated":"2019-11-18 19:57:22.000000000","message":"Done","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"eb2a72bb8684ba31ccf4860ef64f5cba148c2597","unresolved":false,"context_lines":[{"line_number":72,"context_line":"the PTL information gathered that would be good to help other"},{"line_number":73,"context_line":"PTLs brainstorm. Though I think a lot of this information will be"},{"line_number":74,"context_line":"quite different from project to project, we can still try to standardize"},{"line_number":75,"context_line":"on format and location across all projects documenation. "},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"Other projects, like Octavia and Swift, already have a lot of project"},{"line_number":78,"context_line":"specific docs for new contributors that could be used to make some"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_7169adf6","line":75,"range":{"start_line":75,"start_character":56,"end_line":75,"end_character":57},"updated":"2019-11-07 11:03:59.000000000","message":"ditto","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"de8e4a87821fc858c5d6c7e50d4075b5f89e3732","unresolved":false,"context_lines":[{"line_number":72,"context_line":"the PTL information gathered that would be good to help other"},{"line_number":73,"context_line":"PTLs brainstorm. Though I think a lot of this information will be"},{"line_number":74,"context_line":"quite different from project to project, we can still try to standardize"},{"line_number":75,"context_line":"on format and location across all projects documenation. "},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"Other projects, like Octavia and Swift, already have a lot of project"},{"line_number":78,"context_line":"specific docs for new contributors that could be used to make some"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3fa7e38b_70884b70","line":75,"range":{"start_line":75,"start_character":56,"end_line":75,"end_character":57},"in_reply_to":"3fa7e38b_7169adf6","updated":"2019-11-18 19:57:22.000000000","message":"Done","commit_id":"b5c8791ab07a2a23a9009a030ab4af176822985d"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"f69c9186e59e6f96ad25749fe5287d29077140a1","unresolved":false,"context_lines":[{"line_number":55,"context_line":""},{"line_number":56,"context_line":"I honestly can\u0027t think of any so I am open to ideas. Leaving the list"},{"line_number":57,"context_line":"below blank for now."},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"#."},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"References"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_946fdbc2","line":58,"range":{"start_line":58,"start_character":0,"end_line":58,"end_character":0},"updated":"2019-11-20 17:41:30.000000000","message":"The main thing I would like to see is the template for both the doc. \n\nDuring the proposed phase of goal, we need to finalize the implementation details of the goal which is finalizing the template for both the guide doc.","commit_id":"24c24688d786afaf460202d2a5e8762dc14bfe2c"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"c1b8d7f014431c8eefe179fa73ee2c3b2f8f7d59","unresolved":false,"context_lines":[{"line_number":55,"context_line":""},{"line_number":56,"context_line":"I honestly can\u0027t think of any so I am open to ideas. Leaving the list"},{"line_number":57,"context_line":"below blank for now."},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"#."},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"References"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_889d3ebc","line":58,"range":{"start_line":58,"start_character":0,"end_line":58,"end_character":0},"in_reply_to":"3fa7e38b_946fdbc2","updated":"2019-12-03 19:48:41.000000000","message":"Done","commit_id":"24c24688d786afaf460202d2a5e8762dc14bfe2c"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"f69c9186e59e6f96ad25749fe5287d29077140a1","unresolved":false,"context_lines":[{"line_number":68,"context_line":"Current State / Anticipated Impact"},{"line_number":69,"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"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"There are some projects, like Nova, that already have some of"},{"line_number":72,"context_line":"the PTL information gathered that would be good to help other"},{"line_number":73,"context_line":"PTLs brainstorm. Though I think a lot of this information will be"},{"line_number":74,"context_line":"quite different from project to project, we can still try to standardize"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_d450f30c","line":71,"range":{"start_line":71,"start_character":0,"end_line":71,"end_character":61},"updated":"2019-11-20 17:41:30.000000000","message":"can we add the link also\n\n- https://docs.openstack.org/nova/latest/contributor/ptl-guide.html","commit_id":"24c24688d786afaf460202d2a5e8762dc14bfe2c"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"c1b8d7f014431c8eefe179fa73ee2c3b2f8f7d59","unresolved":false,"context_lines":[{"line_number":68,"context_line":"Current State / Anticipated Impact"},{"line_number":69,"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"},{"line_number":70,"context_line":""},{"line_number":71,"context_line":"There are some projects, like Nova, that already have some of"},{"line_number":72,"context_line":"the PTL information gathered that would be good to help other"},{"line_number":73,"context_line":"PTLs brainstorm. Though I think a lot of this information will be"},{"line_number":74,"context_line":"quite different from project to project, we can still try to standardize"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_c859f628","line":71,"range":{"start_line":71,"start_character":0,"end_line":71,"end_character":61},"in_reply_to":"3fa7e38b_d450f30c","updated":"2019-12-03 19:48:41.000000000","message":"Done","commit_id":"24c24688d786afaf460202d2a5e8762dc14bfe2c"},{"author":{"_account_id":308,"name":"Thierry Carrez","email":"thierry@openstack.org","username":"ttx"},"change_message_id":"07a1cb242d6800fe1e86aedc75d9bbd7a7a8045a","unresolved":false,"context_lines":[{"line_number":72,"context_line":"the PTL information gathered that would be good to help other"},{"line_number":73,"context_line":"PTLs brainstorm. Though I think a lot of this information will be"},{"line_number":74,"context_line":"quite different from project to project, we can still try to standardize"},{"line_number":75,"context_line":"on format and location across all projects documenation. "},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"Other projects, like Octavia and Swift, already have a lot of project"},{"line_number":78,"context_line":"specific docs for new contributors that could be used to make some"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_503164a1","line":75,"range":{"start_line":75,"start_character":43,"end_line":75,"end_character":55},"updated":"2019-11-21 10:54:45.000000000","message":"documentation","commit_id":"24c24688d786afaf460202d2a5e8762dc14bfe2c"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"c1b8d7f014431c8eefe179fa73ee2c3b2f8f7d59","unresolved":false,"context_lines":[{"line_number":72,"context_line":"the PTL information gathered that would be good to help other"},{"line_number":73,"context_line":"PTLs brainstorm. Though I think a lot of this information will be"},{"line_number":74,"context_line":"quite different from project to project, we can still try to standardize"},{"line_number":75,"context_line":"on format and location across all projects documenation. "},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"Other projects, like Octavia and Swift, already have a lot of project"},{"line_number":78,"context_line":"specific docs for new contributors that could be used to make some"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_689a42c5","line":75,"range":{"start_line":75,"start_character":43,"end_line":75,"end_character":55},"in_reply_to":"3fa7e38b_503164a1","updated":"2019-12-03 19:48:41.000000000","message":"Done","commit_id":"24c24688d786afaf460202d2a5e8762dc14bfe2c"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"603ae305594b76af546e920ad8d964de8363f6f8","unresolved":false,"context_lines":[{"line_number":46,"context_line":"Completion Criteria"},{"line_number":47,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"#. There exists a PTL specific guide in each project\u0027s docs with"},{"line_number":50,"context_line":"   all extra duties they perform beyond the common set enumerated"},{"line_number":51,"context_line":"   in the project team guide in the becoming a PTL section."},{"line_number":52,"context_line":"#. There exists a section of project specific information about"},{"line_number":53,"context_line":"   contribution to that project in each project\u0027s documentation."},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"References"},{"line_number":56,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3fa7e38b_e1f3a1e7","line":53,"range":{"start_line":49,"start_character":0,"end_line":53,"end_character":64},"updated":"2019-11-26 18:11:10.000000000","message":"I still think we need to template here first for both guide so that each project can understand what actually they need to write in a consistent way. \n\nContributor.rst - this should be a standard template for all the projects. Like you mentioned about cookiecutter things. mentioning that here will be good.  \n\nPTL_guide.rst - This varies from project to project but still we have lot of common practice to share between PTL. if we can add a specific template for this with more optional fields that can be skipped/filled depends on project nature.  \n\nOtherwise, I feel it can lead to lot of inconsistency in those guides.","commit_id":"b0a49634e46426ec9f6a3008b1a77826e75774b0"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"bd4abbc4fae69a3b773748ea7ec9faba7b3f7ddc","unresolved":false,"context_lines":[{"line_number":46,"context_line":"Completion Criteria"},{"line_number":47,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"#. There exists a PTL specific guide in each project\u0027s docs with"},{"line_number":50,"context_line":"   all extra duties they perform beyond the common set enumerated"},{"line_number":51,"context_line":"   in the project team guide in the becoming a PTL section."},{"line_number":52,"context_line":"#. There exists a section of project specific information about"},{"line_number":53,"context_line":"   contribution to that project in each project\u0027s documentation."},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"References"},{"line_number":56,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3fa7e38b_99b1e004","line":53,"range":{"start_line":49,"start_character":0,"end_line":53,"end_character":64},"in_reply_to":"3fa7e38b_534ef9c2","updated":"2019-11-28 17:48:21.000000000","message":"\u0027real soon\u0027? you mean during the selection phase. \n\n\u0027proposed\u0027 phase is the iterable process before \u0027selection\u0027 phase so I am ok it can be reiterated to define the template before it goes to \u0027selection\u0027 goal phase.\n\nBecause before \u0027selection\u0027 phase, we need to have the complete implementation details.","commit_id":"b0a49634e46426ec9f6a3008b1a77826e75774b0"},{"author":{"_account_id":16708,"name":"Kendall Nelson","display_name":"Kendall (diablo_rojo)","email":"kennelson11@gmail.com","username":"kjnelson"},"change_message_id":"c1b8d7f014431c8eefe179fa73ee2c3b2f8f7d59","unresolved":false,"context_lines":[{"line_number":46,"context_line":"Completion Criteria"},{"line_number":47,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"#. There exists a PTL specific guide in each project\u0027s docs with"},{"line_number":50,"context_line":"   all extra duties they perform beyond the common set enumerated"},{"line_number":51,"context_line":"   in the project team guide in the becoming a PTL section."},{"line_number":52,"context_line":"#. There exists a section of project specific information about"},{"line_number":53,"context_line":"   contribution to that project in each project\u0027s documentation."},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"References"},{"line_number":56,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3fa7e38b_f97a1f75","line":53,"range":{"start_line":49,"start_character":0,"end_line":53,"end_character":64},"in_reply_to":"3fa7e38b_99b1e004","updated":"2019-12-03 19:48:41.000000000","message":"I have the template patch linked down on line 62.","commit_id":"b0a49634e46426ec9f6a3008b1a77826e75774b0"},{"author":{"_account_id":8099,"name":"Graham Hayes","email":"gr@ham.ie","username":"graham"},"change_message_id":"f264a760b0ba67468b76a88bd4b20ce2f206ad56","unresolved":false,"context_lines":[{"line_number":46,"context_line":"Completion Criteria"},{"line_number":47,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"#. There exists a PTL specific guide in each project\u0027s docs with"},{"line_number":50,"context_line":"   all extra duties they perform beyond the common set enumerated"},{"line_number":51,"context_line":"   in the project team guide in the becoming a PTL section."},{"line_number":52,"context_line":"#. There exists a section of project specific information about"},{"line_number":53,"context_line":"   contribution to that project in each project\u0027s documentation."},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"References"},{"line_number":56,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3fa7e38b_534ef9c2","line":53,"range":{"start_line":49,"start_character":0,"end_line":53,"end_character":64},"in_reply_to":"3fa7e38b_e1f3a1e7","updated":"2019-11-27 16:04:57.000000000","message":"I don\u0027t think we need the templates right now, but real soon after we merge. I don\u0027t think we should hold off on merging this waiting for them","commit_id":"b0a49634e46426ec9f6a3008b1a77826e75774b0"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"2ba4880d6273cc86f400f1921e24aecb6c97223c","unresolved":false,"context_lines":[{"line_number":46,"context_line":"Completion Criteria"},{"line_number":47,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"#. There exists a PTL specific guide in each project\u0027s docs with"},{"line_number":50,"context_line":"   all extra duties they perform beyond the common set enumerated"},{"line_number":51,"context_line":"   in the project team guide in the becoming a PTL section."},{"line_number":52,"context_line":"#. There exists a section of project specific information about"},{"line_number":53,"context_line":"   contribution to that project in each project\u0027s documentation."},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"References"},{"line_number":56,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":5,"id":"3fa7e38b_245c0e7c","line":53,"range":{"start_line":49,"start_character":0,"end_line":53,"end_character":64},"in_reply_to":"3fa7e38b_f97a1f75","updated":"2019-12-03 21:20:28.000000000","message":"I see. Thanks. left the few review comment there. \n\nIt will be good if you can add the cookiecutter review link here along with how to create both guides. Something like \n\n* How to prepare the Contributor Guide: Each project will use the cookiecutter template as defined in https://review.opendev.org/696001 and fill the required information.\n\n* How to prepare the PTL Guide: \n\n        I cannot find the template for this. It will be good if you can prepare the same cookiecutter for PTL guide too.","commit_id":"b0a49634e46426ec9f6a3008b1a77826e75774b0"}],"goals/selected/ussuri/project-ptl-and-contrib-docs.rst":[{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"f69c9186e59e6f96ad25749fe5287d29077140a1","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":2,"id":"3fa7e38b_947d9b6e","updated":"2019-11-20 17:41:30.000000000","message":"we need to make this in separate patch because that is a separate phase of goal. \n\nWe all agreed to make it ussuri goal so that will be a quick merge once we all agree on implementation detail.\n\nIf we do it in the same patch then, I feel we can do directly in selected/ussuri dir as I did for py2 goal. \n\nOtherwise, you will end up updating/copying the same doc in two places which is confusing during the review especifally extra work to verify that both are the same.","commit_id":"24c24688d786afaf460202d2a5e8762dc14bfe2c"}]}