)]}'
{"/PATCHSET_LEVEL":[{"author":{"_account_id":10342,"name":"Jay Faulkner","display_name":"JayF","email":"jay@jvf.cc","username":"JayF","status":"youtube.com/@oss-gr / podcast.gr-oss.io"},"change_message_id":"3d188636a27871394e037d76881d35b7ebab8235","unresolved":true,"context_lines":[],"source_content_type":"","patch_set":2,"id":"ecc3d87a_33bd3f91","updated":"2024-07-04 16:36:07.000000000","message":"When this lands, I have some ideas for follow-up along the lines of my earlier comment.","commit_id":"a36fd00951f42057a06f1cf09db9e02ed1e8354a"}],"doc/source/contributor/index.rst":[{"author":{"_account_id":10342,"name":"Jay Faulkner","display_name":"JayF","email":"jay@jvf.cc","username":"JayF","status":"youtube.com/@oss-gr / podcast.gr-oss.io"},"change_message_id":"280aa792dc4084e9ddbe067cd0bc3830eb7d97e1","unresolved":true,"context_lines":[{"line_number":21,"context_line":".. toctree::"},{"line_number":22,"context_line":"   :maxdepth: 2"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"   dev-quickstart"},{"line_number":25,"context_line":"   devstack-guide"},{"line_number":26,"context_line":"   bifrost-dev-guide"},{"line_number":27,"context_line":"   local-dev-guide"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3e08798d_f42232ab","line":24,"updated":"2024-06-24 20:58:23.000000000","message":"I think there\u0027s value in having people funnel through dev-quickstart since it gives context on pre-commit, running unit tests, and usefulness of these different dev environments. Directly linking these dev guides without that context will be, IMO, a net-loss in usefulness.\n\nI\u0027d suggest completely deconstructing dev-quickstart:\n- Move infromation on pre-commit + running unit tests to a unit-test-specific page \n- Move the entire testing environment table from dev-quickstart into here\n- Add a row for unit test / pre-commit info with a link to the newly created one\n- Remove remainder of info from dev-quickstart and move to a top level \"advanced topics\" or similar page. TBH I\u0027m not even sure if most of the info (e.g. osprofiler) is useful anymore\n- Change dev-quickstart to a shell page that links back here just so old links aren\u0027t killed","commit_id":"a36fd00951f42057a06f1cf09db9e02ed1e8354a"},{"author":{"_account_id":10342,"name":"Jay Faulkner","display_name":"JayF","email":"jay@jvf.cc","username":"JayF","status":"youtube.com/@oss-gr / podcast.gr-oss.io"},"change_message_id":"5b11aea5599e40859148c363dd5e14a92b8d357b","unresolved":true,"context_lines":[{"line_number":21,"context_line":".. toctree::"},{"line_number":22,"context_line":"   :maxdepth: 2"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"   dev-quickstart"},{"line_number":25,"context_line":"   devstack-guide"},{"line_number":26,"context_line":"   bifrost-dev-guide"},{"line_number":27,"context_line":"   local-dev-guide"}],"source_content_type":"text/x-rst","patch_set":2,"id":"b9a825e4_a23ee84a","line":24,"in_reply_to":"1a531736_923cc79b","updated":"2024-06-25 14:40:20.000000000","message":"\u003e Could you elaborate on why? Feel free to use me as an example: I\u0027m very annoyed by searching for the devstack guide each time. Essentially, I use grep on doc/source instead to find it. Do you suggest newcomers do the same?\n\nMy suggestion, I think, would still resolve this issue? I know it\u0027s maybe more than you wanted to take on, so perhaps in a followup (from me/you/whoever gets to it)?\n\n\u003e Another experiment: many times people come and ask for a development environment. How many times have you personally starting with explaining them unit tests, pre-commit and stuff? I haven\u0027t seen that.\n\nAlmost everytime I onboard someone to OpenStack I have to assert to them they don\u0027t need to run a devstack to run unit tests. It\u0027s a more common misconception than you might think.\n\n\u003e I guess the assumption you make is that every person that may want to start with DevStack also needs a complete introduction into OpenStack development. Citation needed, I don\u0027t think it\u0027s actually the case.\n\nThat\u0027s fair, but I do think the problem mentioned above is a thing. At a minimum we should have a little text acting as a traffic cop directing people to the rgiht place.","commit_id":"a36fd00951f42057a06f1cf09db9e02ed1e8354a"},{"author":{"_account_id":10239,"name":"Dmitry Tantsur","email":"dtantsur@protonmail.com","username":"dtantsur"},"change_message_id":"78c5801a3f87916fc1ccfba47e24b9f87b6f5002","unresolved":true,"context_lines":[{"line_number":21,"context_line":".. toctree::"},{"line_number":22,"context_line":"   :maxdepth: 2"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"   dev-quickstart"},{"line_number":25,"context_line":"   devstack-guide"},{"line_number":26,"context_line":"   bifrost-dev-guide"},{"line_number":27,"context_line":"   local-dev-guide"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a531736_923cc79b","line":24,"in_reply_to":"3e08798d_f42232ab","updated":"2024-06-25 11:48:26.000000000","message":"\u003e I think there\u0027s value in having people funnel through dev-quickstart since it gives context on pre-commit, running unit tests, and usefulness of these different dev environments.\n\nCould you elaborate on why? Feel free to use me as an example: I\u0027m very annoyed by searching for the devstack guide each time. Essentially, I use grep on doc/source instead to find it. Do you suggest newcomers do the same?\n\nAnother experiment: many times people come and ask for a development environment. How many times have you personally starting with explaining them unit tests, pre-commit and stuff? I haven\u0027t seen that.\n\nI guess the assumption you make is that every person that may want to start with DevStack also needs a complete introduction into OpenStack development. Citation needed, I don\u0027t think it\u0027s actually the case.\n\n\u003e I\u0027d suggest completely deconstructing dev-quickstart:\n\nThis is something I\u0027ll never have time for, but feel free to take over this patch.","commit_id":"a36fd00951f42057a06f1cf09db9e02ed1e8354a"},{"author":{"_account_id":10342,"name":"Jay Faulkner","display_name":"JayF","email":"jay@jvf.cc","username":"JayF","status":"youtube.com/@oss-gr / podcast.gr-oss.io"},"change_message_id":"bf00e1612f157fb181092f1b9731d8b743b742c1","unresolved":true,"context_lines":[{"line_number":21,"context_line":".. toctree::"},{"line_number":22,"context_line":"   :maxdepth: 2"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"   dev-quickstart"},{"line_number":25,"context_line":"   devstack-guide"},{"line_number":26,"context_line":"   bifrost-dev-guide"},{"line_number":27,"context_line":"   local-dev-guide"}],"source_content_type":"text/x-rst","patch_set":2,"id":"d9ecf6c8_34a0c0b2","line":24,"in_reply_to":"9c9c3bd2_d5defb9a","updated":"2024-06-25 16:38:05.000000000","message":"Yeah, we should probably just merge it as-is or with minor changes, I can rip out dev-quickstart afterwards which is a long-standing personal vendetta 😄 (two start-pages for contributor docs has always been tough).","commit_id":"a36fd00951f42057a06f1cf09db9e02ed1e8354a"},{"author":{"_account_id":10239,"name":"Dmitry Tantsur","email":"dtantsur@protonmail.com","username":"dtantsur"},"change_message_id":"d3cc490a5964fedd8418334c559b4ec54d975386","unresolved":true,"context_lines":[{"line_number":21,"context_line":".. toctree::"},{"line_number":22,"context_line":"   :maxdepth: 2"},{"line_number":23,"context_line":""},{"line_number":24,"context_line":"   dev-quickstart"},{"line_number":25,"context_line":"   devstack-guide"},{"line_number":26,"context_line":"   bifrost-dev-guide"},{"line_number":27,"context_line":"   local-dev-guide"}],"source_content_type":"text/x-rst","patch_set":2,"id":"9c9c3bd2_d5defb9a","line":24,"in_reply_to":"b9a825e4_a23ee84a","updated":"2024-06-25 15:12:40.000000000","message":"\u003e Almost everytime I onboard someone to OpenStack I have to assert to them they don\u0027t need to run a devstack to run unit tests. It\u0027s a more common misconception than you might think.\n\nI can believe you, I\u0027m not sure my patch makes it really worse for them. After all, they somehow find devstack already, despite it being carefully hidden.\n\n\u003e At a minimum we should have a little text acting as a traffic cop directing people to the rgiht place.\n\nLet me check the current text.","commit_id":"a36fd00951f42057a06f1cf09db9e02ed1e8354a"}]}