)]}'
{"doc/source/contributor/jobs-description.rst":[{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"26407ac5acaf7689cab390070df0535467962dc9","unresolved":false,"context_lines":[{"line_number":4,"context_line":"Jobs description"},{"line_number":5,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The description of each jobs that runs in the CI when you submit a patch for"},{"line_number":8,"context_line":"`openstack/ironic-lib` is shown in the following table."},{"line_number":9,"context_line":""},{"line_number":10,"context_line":".. note::"}],"source_content_type":"text/x-rst","patch_set":1,"id":"7faddb67_54addf81","line":7,"updated":"2019-08-19 15:45:25.000000000","message":"nit. s/jobs/job/","commit_id":"12af6570deb758e52bbe73050cd8c1415be738fa"},{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"26407ac5acaf7689cab390070df0535467962dc9","unresolved":false,"context_lines":[{"line_number":8,"context_line":"`openstack/ironic-lib` is shown in the following table."},{"line_number":9,"context_line":""},{"line_number":10,"context_line":".. note::"},{"line_number":11,"context_line":"    All jobs runs tempest tests that match the regex"},{"line_number":12,"context_line":"    `ironic_tempest_plugin.tests.scenario` and deploys 1 virtual baremetal."},{"line_number":13,"context_line":""},{"line_number":14,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"7faddb67_74b25be7","line":11,"updated":"2019-08-19 15:45:25.000000000","message":"nit s/runs/run/","commit_id":"12af6570deb758e52bbe73050cd8c1415be738fa"},{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"26407ac5acaf7689cab390070df0535467962dc9","unresolved":false,"context_lines":[{"line_number":37,"context_line":"   * - ironic-lib-wholedisk-bios-ipmi-iscsi-tinyipa-src"},{"line_number":38,"context_line":"     - Deploys Ironic in DevStack under Python3, configured to use a pre-build"},{"line_number":39,"context_line":"       tinyipa ramdisk wholedisk image comes from an `iscsi` share, pxe boot,"},{"line_number":40,"context_line":"       ipmi driver."}],"source_content_type":"text/x-rst","patch_set":1,"id":"7faddb67_34d703c2","line":40,"updated":"2019-08-19 15:45:25.000000000","message":"I have seen a few PRs that add CI documentation and am wondering if there had been a discussion about it. This is great but I am concerned that when we change the CI jobs, the documentation will get out of sync. I don\u0027t know that people will remember to update them.\n\nWondering who this documentation is for? Developers only, since this is a library. I was wondering:\n- what about putting a link to the zuul job file: https://opendev.org/openstack/ironic-lib/src/branch/master/zuul.d/ironic-lib-jobs.yaml\n- and is there a way to add comments to a .yaml, so that the actual descriptions are in the .yaml file instead of this doc file? That way, if someone changes the .yaml file, they\u0027ll know to update/add doc.\n\nA developer should know that we are using zuul and that this is the file that defines the jobs so I think a link is useful.","commit_id":"12af6570deb758e52bbe73050cd8c1415be738fa"},{"author":{"_account_id":15519,"name":"Iury Gregory Melo Ferreira","display_name":"Iury Gregory","email":"iurygregory@gmail.com","username":"iurygregory"},"change_message_id":"b21558df6662d51f044eae3642b6629a2606ecac","unresolved":false,"context_lines":[{"line_number":37,"context_line":"   * - ironic-lib-wholedisk-bios-ipmi-iscsi-tinyipa-src"},{"line_number":38,"context_line":"     - Deploys Ironic in DevStack under Python3, configured to use a pre-build"},{"line_number":39,"context_line":"       tinyipa ramdisk wholedisk image comes from an `iscsi` share, pxe boot,"},{"line_number":40,"context_line":"       ipmi driver."}],"source_content_type":"text/x-rst","patch_set":1,"id":"7faddb67_88b57eef","line":40,"in_reply_to":"7faddb67_34d703c2","updated":"2019-09-03 20:31:55.000000000","message":"Hi Ruby, Thanks for the feedback!\n\nWe didn\u0027t have a meeting where we discussed this.\nOne thing I have in mind to avoid the documentation to get out of sync is to create a shell script that would read the yaml and get the description to create the table with the jobs descriptions  and maybe see if would be possible to have a job that would validate if the doc was update if there is a new job in the yaml. (Maybe I\u0027m thinking too much \u003d) )\n\nThe documentation would be most for newcomers in the community, they would have a better idea what each job does.\n\nI can add the link to the zuul job file np.\nThe jobs in the yaml have a field call description, they should provide this type of information, but most of the time we forget about it I would say.","commit_id":"12af6570deb758e52bbe73050cd8c1415be738fa"}],"doc/source/index.rst":[{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"26407ac5acaf7689cab390070df0535467962dc9","unresolved":false,"context_lines":[{"line_number":11,"context_line":"   :maxdepth: 1"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"   Installation and Usage documentation \u003ccontributor/index\u003e"},{"line_number":14,"context_line":"   Ironic Lib CI \u003ccontributor/jobs-description\u003e"},{"line_number":15,"context_line":"   reference/index"},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"* :ref:`genindex`"}],"source_content_type":"text/x-rst","patch_set":1,"id":"7faddb67_3485c3ad","line":14,"updated":"2019-08-19 15:45:25.000000000","message":"Given that this is the ironic-lib repo, I don\u0027t think we need \u0027Ironic Lib\u0027. It\u0027d be more consistent without that. eg, we don\u0027t have \u0027Ironic Lib Installation and Usage documentation\u0027 :)","commit_id":"12af6570deb758e52bbe73050cd8c1415be738fa"},{"author":{"_account_id":15519,"name":"Iury Gregory Melo Ferreira","display_name":"Iury Gregory","email":"iurygregory@gmail.com","username":"iurygregory"},"change_message_id":"0ad1ac2a893e958a58e7294fd4619dd22d4f820c","unresolved":false,"context_lines":[{"line_number":11,"context_line":"   :maxdepth: 1"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"   Installation and Usage documentation \u003ccontributor/index\u003e"},{"line_number":14,"context_line":"   Ironic Lib CI \u003ccontributor/jobs-description\u003e"},{"line_number":15,"context_line":"   reference/index"},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"* :ref:`genindex`"}],"source_content_type":"text/x-rst","patch_set":1,"id":"7faddb67_e8c3d256","line":14,"in_reply_to":"7faddb67_3485c3ad","updated":"2019-09-03 20:32:49.000000000","message":"Sure! Maybe *CI Jobs*?","commit_id":"12af6570deb758e52bbe73050cd8c1415be738fa"},{"author":{"_account_id":6618,"name":"Ruby Loo","email":"opensrloo@gmail.com","username":"rloo"},"change_message_id":"8c8ca73c9652e8d40c9ca8cac098906455d840ae","unresolved":false,"context_lines":[{"line_number":11,"context_line":"   :maxdepth: 1"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"   Installation and Usage documentation \u003ccontributor/index\u003e"},{"line_number":14,"context_line":"   Ironic Lib CI \u003ccontributor/jobs-description\u003e"},{"line_number":15,"context_line":"   reference/index"},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"* :ref:`genindex`"}],"source_content_type":"text/x-rst","patch_set":1,"id":"7faddb67_60c5a08d","line":14,"in_reply_to":"7faddb67_e8c3d256","updated":"2019-09-04 20:31:51.000000000","message":"++","commit_id":"12af6570deb758e52bbe73050cd8c1415be738fa"}]}