)]}'
{"doc/source/contributing/documentation.rst":[{"author":{"_account_id":2537,"name":"Nikhil Komawar","email":"nik.komawar@gmail.com","username":"nikhil-komawar"},"change_message_id":"da6ecf9ab48c6268f3af4ed8525cade2f16fc394","unresolved":false,"context_lines":[{"line_number":51,"context_line":"  you notice structural improvements that our API reference is missing, please"},{"line_number":52,"context_line":"  file a bug.  And, of course, we would also welcome your patch implementing"},{"line_number":53,"context_line":"  the improvement!"},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"Release Notes"},{"line_number":56,"context_line":"-------------"},{"line_number":57,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"da7fb54a_50747ace","line":54,"updated":"2016-09-02 16:47:49.000000000","message":"fixing this here on purpose.\n\nproposing a separate commit for such a change seems rather useless and it\u0027s not going to affect git history significantly anyway:\n\na blank doc line changed in a commit that doesn\u0027t have it\u0027s mention does not seem to affect anybody to me.","commit_id":"070d78597c3f351589b4d6a4666427e7560a45d3"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"02cb2a05607d5d441cc5b388e3d6afe77484826c","unresolved":false,"context_lines":[{"line_number":51,"context_line":"  you notice structural improvements that our API reference is missing, please"},{"line_number":52,"context_line":"  file a bug.  And, of course, we would also welcome your patch implementing"},{"line_number":53,"context_line":"  the improvement!"},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"Release Notes"},{"line_number":56,"context_line":"-------------"},{"line_number":57,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"da7fb54a_566ab21b","line":54,"in_reply_to":"da7fb54a_50747ace","updated":"2016-09-02 17:30:21.000000000","message":"ok ... I couldn\u0027t tell from the diff in gerrit, but there was extraneous whitespace on this \"blank\" line.  I agree, might as well kill it in this commit.","commit_id":"070d78597c3f351589b4d6a4666427e7560a45d3"},{"author":{"_account_id":22448,"name":"Alexander Bashmakov","email":"abashmak@yahoo.com","username":"abashmak"},"change_message_id":"f36df45324d39b9694294504db70f449fd0cfb7b","unresolved":false,"context_lines":[{"line_number":85,"context_line":"This will create the HTML files under ``releasenotes/build/html/``."},{"line_number":86,"context_line":""},{"line_number":87,"context_line":"**NOTE**: The ``prelude`` section in the release notes is to highlight only the"},{"line_number":88,"context_line":"important changes part of the release. Please word your note accordingly and"},{"line_number":89,"context_line":"be judicious while adding notes there. We don\u0027t encourage extraneous notes and"},{"line_number":90,"context_line":"we don\u0027t want to miss out on important ones."}],"source_content_type":"text/x-rst","patch_set":2,"id":"da7fb54a_fb1f2f59","line":88,"range":{"start_line":88,"start_character":18,"end_line":88,"end_character":22},"updated":"2016-09-02 16:54:29.000000000","message":"s/part/portion/ or s/part//","commit_id":"070d78597c3f351589b4d6a4666427e7560a45d3"},{"author":{"_account_id":2537,"name":"Nikhil Komawar","email":"nik.komawar@gmail.com","username":"nikhil-komawar"},"change_message_id":"0028521ea05e28cf1fe6559f996e9fafcf095790","unresolved":false,"context_lines":[{"line_number":85,"context_line":"This will create the HTML files under ``releasenotes/build/html/``."},{"line_number":86,"context_line":""},{"line_number":87,"context_line":"**NOTE**: The ``prelude`` section in the release notes is to highlight only the"},{"line_number":88,"context_line":"important changes part of the release. Please word your note accordingly and"},{"line_number":89,"context_line":"be judicious while adding notes there. We don\u0027t encourage extraneous notes and"},{"line_number":90,"context_line":"we don\u0027t want to miss out on important ones."}],"source_content_type":"text/x-rst","patch_set":2,"id":"9a89bdaa_e291cd9a","line":88,"range":{"start_line":88,"start_character":18,"end_line":88,"end_character":22},"in_reply_to":"da7fb54a_fb1f2f59","updated":"2016-09-06 19:32:57.000000000","message":"Done","commit_id":"070d78597c3f351589b4d6a4666427e7560a45d3"},{"author":{"_account_id":22448,"name":"Alexander Bashmakov","email":"abashmak@yahoo.com","username":"abashmak"},"change_message_id":"f36df45324d39b9694294504db70f449fd0cfb7b","unresolved":false,"context_lines":[{"line_number":86,"context_line":""},{"line_number":87,"context_line":"**NOTE**: The ``prelude`` section in the release notes is to highlight only the"},{"line_number":88,"context_line":"important changes part of the release. Please word your note accordingly and"},{"line_number":89,"context_line":"be judicious while adding notes there. We don\u0027t encourage extraneous notes and"},{"line_number":90,"context_line":"we don\u0027t want to miss out on important ones."}],"source_content_type":"text/x-rst","patch_set":2,"id":"da7fb54a_5b657bdf","line":89,"range":{"start_line":89,"start_character":13,"end_line":89,"end_character":31},"updated":"2016-09-02 16:54:29.000000000","message":"s/while adding notes/when adding content/","commit_id":"070d78597c3f351589b4d6a4666427e7560a45d3"},{"author":{"_account_id":2537,"name":"Nikhil Komawar","email":"nik.komawar@gmail.com","username":"nikhil-komawar"},"change_message_id":"0028521ea05e28cf1fe6559f996e9fafcf095790","unresolved":false,"context_lines":[{"line_number":86,"context_line":""},{"line_number":87,"context_line":"**NOTE**: The ``prelude`` section in the release notes is to highlight only the"},{"line_number":88,"context_line":"important changes part of the release. Please word your note accordingly and"},{"line_number":89,"context_line":"be judicious while adding notes there. We don\u0027t encourage extraneous notes and"},{"line_number":90,"context_line":"we don\u0027t want to miss out on important ones."}],"source_content_type":"text/x-rst","patch_set":2,"id":"9a89bdaa_62f4ddf1","line":89,"range":{"start_line":89,"start_character":13,"end_line":89,"end_character":31},"in_reply_to":"da7fb54a_5b657bdf","updated":"2016-09-06 19:32:57.000000000","message":"Done","commit_id":"070d78597c3f351589b4d6a4666427e7560a45d3"},{"author":{"_account_id":5314,"name":"Brian Rosmaita","email":"rosmaita.fossdev@gmail.com","username":"brian-rosmaita"},"change_message_id":"02cb2a05607d5d441cc5b388e3d6afe77484826c","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":2,"id":"da7fb54a_d66242ad","line":91,"updated":"2016-09-02 17:30:21.000000000","message":"Maybe we should make this advice a bit stronger and explicitly say that a prelude section is not required for each release note, and maybe give an example?  Or instead of an example, maybe \"If what you\u0027re working on required a spec, then a prelude is appropriate.  If you\u0027re submitting a bugfix, most likely not; a spec-lite is a judgement call\".","commit_id":"070d78597c3f351589b4d6a4666427e7560a45d3"},{"author":{"_account_id":2537,"name":"Nikhil Komawar","email":"nik.komawar@gmail.com","username":"nikhil-komawar"},"change_message_id":"0028521ea05e28cf1fe6559f996e9fafcf095790","unresolved":false,"context_lines":[],"source_content_type":"","patch_set":2,"id":"9a89bdaa_220655ce","line":91,"in_reply_to":"da7fb54a_d66242ad","updated":"2016-09-06 19:32:57.000000000","message":"Done","commit_id":"070d78597c3f351589b4d6a4666427e7560a45d3"},{"author":{"_account_id":8158,"name":"Hemanth Makkapati","email":"makstacker+osgerrit@gmail.com","username":"hemanth.makkapati"},"change_message_id":"36512cd762458e00bd18e0af4b91b678d17f378c","unresolved":false,"context_lines":[{"line_number":90,"context_line":"the same time we don\u0027t want to miss out on important ones. In short, not every"},{"line_number":91,"context_line":"release note will need content in the ``prelude`` section. If what you\u0027re"},{"line_number":92,"context_line":"working on required a spec, then a prelude is appropriate. If you\u0027re submitting"},{"line_number":93,"context_line":"a bugfix, most likely not; a spec-lite is a judgement call."}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a8bc5a2_8dbdad6a","line":93,"updated":"2016-09-23 15:43:33.000000000","message":"What about security fixes?","commit_id":"a75ddd4112f2d7297ffa5aad45b450246dadcae5"},{"author":{"_account_id":12000,"name":"Ian Cordasco","email":"sigmavirus24@gmail.com","username":"sigmavirus24"},"change_message_id":"11242e209f2a000d868f34966084167b0a443c3a","unresolved":false,"context_lines":[{"line_number":90,"context_line":"the same time we don\u0027t want to miss out on important ones. In short, not every"},{"line_number":91,"context_line":"release note will need content in the ``prelude`` section. If what you\u0027re"},{"line_number":92,"context_line":"working on required a spec, then a prelude is appropriate. If you\u0027re submitting"},{"line_number":93,"context_line":"a bugfix, most likely not; a spec-lite is a judgement call."}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a8bc5a2_88003b03","line":93,"in_reply_to":"5a8bc5a2_8dbdad6a","updated":"2016-09-23 15:47:12.000000000","message":"I think the fact that they\u0027re in their own section is enough. If they didn\u0027t have their own section, I\u0027d agree with you Hemanth.","commit_id":"a75ddd4112f2d7297ffa5aad45b450246dadcae5"}]}