)]}'
{"doc/source/devref/development_best_practices.rst":[{"author":{"_account_id":21420,"name":"Gage Hugo","email":"gagehugo@gmail.com","username":"ghugo"},"change_message_id":"fcf600f6062870971fa35702bd34d4cd33c94f9f","unresolved":false,"context_lines":[{"line_number":165,"context_line":"a feature. A release note should be included in the same patch the work is"},{"line_number":166,"context_line":"being performed. Release notes must also be easy to read, link back to"},{"line_number":167,"context_line":"appropriate documentation readers may need, and be easy to maintain. The"},{"line_number":168,"context_line":"following conventions help the team unsure all release notes achieve those"},{"line_number":169,"context_line":"goals."},{"line_number":170,"context_line":""},{"line_number":171,"context_line":"Most release notes either describe bug fixes or announce support for new"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3a1ff146_cd6c610b","line":168,"range":{"start_line":168,"start_character":36,"end_line":168,"end_character":42},"updated":"2017-03-14 15:10:35.000000000","message":"s/unsure/ensure\n\nDon\u0027t want to be unsure of our release notes :)","commit_id":"e1c8600349f49c0a5cf75bc4d965b1fe4bc9f7f0"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"6622658363be2c749e40c9e064604b31dc912a62","unresolved":false,"context_lines":[{"line_number":165,"context_line":"a feature. A release note should be included in the same patch the work is"},{"line_number":166,"context_line":"being performed. Release notes must also be easy to read, link back to"},{"line_number":167,"context_line":"appropriate documentation readers may need, and be easy to maintain. The"},{"line_number":168,"context_line":"following conventions help the team unsure all release notes achieve those"},{"line_number":169,"context_line":"goals."},{"line_number":170,"context_line":""},{"line_number":171,"context_line":"Most release notes either describe bug fixes or announce support for new"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3a1ff146_789089ed","line":168,"in_reply_to":"3a1ff146_cd6c610b","updated":"2017-03-14 15:23:57.000000000","message":"Good catch. Done.","commit_id":"e1c8600349f49c0a5cf75bc4d965b1fe4bc9f7f0"},{"author":{"_account_id":18338,"name":"Ron De Rose","email":"ronald.de.rose@intel.com","username":"derosenet"},"change_message_id":"554399060797d1d72826d1eb4fee3bddd9a37337","unresolved":false,"context_lines":[{"line_number":161,"context_line":"The Keystone team uses `reno"},{"line_number":162,"context_line":"\u003chttps://docs.openstack.org/developer/reno/usage.html\u003e`_ to generate release"},{"line_number":163,"context_line":"notes. These are important user-facing documents that must be included when a"},{"line_number":164,"context_line":"user or operator facing change is performed, like fixing a bug or implementing"},{"line_number":165,"context_line":"a feature. A release note should be included in the same patch the work is"},{"line_number":166,"context_line":"being performed. Release notes must also be easy to read, link back to"},{"line_number":167,"context_line":"appropriate documentation readers may need, and be easy to maintain. The"},{"line_number":168,"context_line":"following conventions help the team ensure all release notes achieve those"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_fea3814d","line":165,"range":{"start_line":164,"start_character":45,"end_line":165,"end_character":9},"updated":"2017-03-14 16:11:51.000000000","message":"like a bug-fix or a new feature.","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"979c25f7a8430c6c57bc2fb9dbfa2e3ff97b0ee1","unresolved":false,"context_lines":[{"line_number":162,"context_line":"\u003chttps://docs.openstack.org/developer/reno/usage.html\u003e`_ to generate release"},{"line_number":163,"context_line":"notes. These are important user-facing documents that must be included when a"},{"line_number":164,"context_line":"user or operator facing change is performed, like fixing a bug or implementing"},{"line_number":165,"context_line":"a feature. A release note should be included in the same patch the work is"},{"line_number":166,"context_line":"being performed. Release notes must also be easy to read, link back to"},{"line_number":167,"context_line":"appropriate documentation readers may need, and be easy to maintain. The"},{"line_number":168,"context_line":"following conventions help the team ensure all release notes achieve those"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_83b68ada","line":165,"in_reply_to":"3a1ff146_0097f090","updated":"2017-03-15 14:05:08.000000000","message":"Done","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"979c25f7a8430c6c57bc2fb9dbfa2e3ff97b0ee1","unresolved":false,"context_lines":[{"line_number":162,"context_line":"\u003chttps://docs.openstack.org/developer/reno/usage.html\u003e`_ to generate release"},{"line_number":163,"context_line":"notes. These are important user-facing documents that must be included when a"},{"line_number":164,"context_line":"user or operator facing change is performed, like fixing a bug or implementing"},{"line_number":165,"context_line":"a feature. A release note should be included in the same patch the work is"},{"line_number":166,"context_line":"being performed. Release notes must also be easy to read, link back to"},{"line_number":167,"context_line":"appropriate documentation readers may need, and be easy to maintain. The"},{"line_number":168,"context_line":"following conventions help the team ensure all release notes achieve those"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_63ab4e75","line":165,"in_reply_to":"3a1ff146_fea3814d","updated":"2017-03-15 14:05:08.000000000","message":"Done","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":11022,"name":"Rodrigo Duarte Sousa","email":"rodrigodsousa@gmail.com","username":"rodrigods"},"change_message_id":"9186aaf70a50262bb7f05ce8c1a1b4e67469f77a","unresolved":false,"context_lines":[{"line_number":161,"context_line":"The Keystone team uses `reno"},{"line_number":162,"context_line":"\u003chttps://docs.openstack.org/developer/reno/usage.html\u003e`_ to generate release"},{"line_number":163,"context_line":"notes. These are important user-facing documents that must be included when a"},{"line_number":164,"context_line":"user or operator facing change is performed, like fixing a bug or implementing"},{"line_number":165,"context_line":"a feature. A release note should be included in the same patch the work is"},{"line_number":166,"context_line":"being performed. Release notes must also be easy to read, link back to"},{"line_number":167,"context_line":"appropriate documentation readers may need, and be easy to maintain. The"},{"line_number":168,"context_line":"following conventions help the team ensure all release notes achieve those"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_0097f090","line":165,"range":{"start_line":164,"start_character":45,"end_line":165,"end_character":9},"in_reply_to":"3a1ff146_fea3814d","updated":"2017-03-15 13:39:09.000000000","message":"liked the suggestion, but I\u0027m fine either way.","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":18338,"name":"Ron De Rose","email":"ronald.de.rose@intel.com","username":"derosenet"},"change_message_id":"554399060797d1d72826d1eb4fee3bddd9a37337","unresolved":false,"context_lines":[{"line_number":163,"context_line":"notes. These are important user-facing documents that must be included when a"},{"line_number":164,"context_line":"user or operator facing change is performed, like fixing a bug or implementing"},{"line_number":165,"context_line":"a feature. A release note should be included in the same patch the work is"},{"line_number":166,"context_line":"being performed. Release notes must also be easy to read, link back to"},{"line_number":167,"context_line":"appropriate documentation readers may need, and be easy to maintain. The"},{"line_number":168,"context_line":"following conventions help the team ensure all release notes achieve those"},{"line_number":169,"context_line":"goals."},{"line_number":170,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_5e2f35a1","line":167,"range":{"start_line":166,"start_character":17,"end_line":167,"end_character":67},"updated":"2017-03-14 16:11:51.000000000","message":"Release notes should be easy to read and maintain; should link back to appropriate documentation readers may need.","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"979c25f7a8430c6c57bc2fb9dbfa2e3ff97b0ee1","unresolved":false,"context_lines":[{"line_number":164,"context_line":"user or operator facing change is performed, like fixing a bug or implementing"},{"line_number":165,"context_line":"a feature. A release note should be included in the same patch the work is"},{"line_number":166,"context_line":"being performed. Release notes must also be easy to read, link back to"},{"line_number":167,"context_line":"appropriate documentation readers may need, and be easy to maintain. The"},{"line_number":168,"context_line":"following conventions help the team ensure all release notes achieve those"},{"line_number":169,"context_line":"goals."},{"line_number":170,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_63d98e21","line":167,"in_reply_to":"3a1ff146_5e2f35a1","updated":"2017-03-15 14:05:08.000000000","message":"Done","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":18338,"name":"Ron De Rose","email":"ronald.de.rose@intel.com","username":"derosenet"},"change_message_id":"554399060797d1d72826d1eb4fee3bddd9a37337","unresolved":false,"context_lines":[{"line_number":178,"context_line":"    Created new notes file in releasenotes/notes/bug-1652012-7c53b9702b10084d.yaml"},{"line_number":179,"context_line":""},{"line_number":180,"context_line":"The body of the release note should clearly explain how the impact will affect"},{"line_number":181,"context_line":"users and operators. It should also detail why the change was necessary since"},{"line_number":182,"context_line":"how the change was implemented can be determined by looking into the commit. It"},{"line_number":183,"context_line":"should also contain a properly formatted link in reStructuredText that points"},{"line_number":184,"context_line":"back to the original bug report used to track the fix. This makes reading"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_594bcf59","line":181,"range":{"start_line":181,"start_character":31,"end_line":181,"end_character":42},"updated":"2017-03-14 16:11:51.000000000","message":"include why","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"979c25f7a8430c6c57bc2fb9dbfa2e3ff97b0ee1","unresolved":false,"context_lines":[{"line_number":178,"context_line":"    Created new notes file in releasenotes/notes/bug-1652012-7c53b9702b10084d.yaml"},{"line_number":179,"context_line":""},{"line_number":180,"context_line":"The body of the release note should clearly explain how the impact will affect"},{"line_number":181,"context_line":"users and operators. It should also detail why the change was necessary since"},{"line_number":182,"context_line":"how the change was implemented can be determined by looking into the commit. It"},{"line_number":183,"context_line":"should also contain a properly formatted link in reStructuredText that points"},{"line_number":184,"context_line":"back to the original bug report used to track the fix. This makes reading"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_23f6b68f","line":181,"in_reply_to":"3a1ff146_594bcf59","updated":"2017-03-15 14:05:08.000000000","message":"Done","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":18338,"name":"Ron De Rose","email":"ronald.de.rose@intel.com","username":"derosenet"},"change_message_id":"554399060797d1d72826d1eb4fee3bddd9a37337","unresolved":false,"context_lines":[{"line_number":178,"context_line":"    Created new notes file in releasenotes/notes/bug-1652012-7c53b9702b10084d.yaml"},{"line_number":179,"context_line":""},{"line_number":180,"context_line":"The body of the release note should clearly explain how the impact will affect"},{"line_number":181,"context_line":"users and operators. It should also detail why the change was necessary since"},{"line_number":182,"context_line":"how the change was implemented can be determined by looking into the commit. It"},{"line_number":183,"context_line":"should also contain a properly formatted link in reStructuredText that points"},{"line_number":184,"context_line":"back to the original bug report used to track the fix. This makes reading"},{"line_number":185,"context_line":"release notes easier because readers can get a quick summary of the change,"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_795fab0e","line":182,"range":{"start_line":181,"start_character":72,"end_line":182,"end_character":76},"updated":"2017-03-14 16:11:51.000000000","message":"but not include implementation details, as that can be found in the commit","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"979c25f7a8430c6c57bc2fb9dbfa2e3ff97b0ee1","unresolved":false,"context_lines":[{"line_number":179,"context_line":""},{"line_number":180,"context_line":"The body of the release note should clearly explain how the impact will affect"},{"line_number":181,"context_line":"users and operators. It should also detail why the change was necessary since"},{"line_number":182,"context_line":"how the change was implemented can be determined by looking into the commit. It"},{"line_number":183,"context_line":"should also contain a properly formatted link in reStructuredText that points"},{"line_number":184,"context_line":"back to the original bug report used to track the fix. This makes reading"},{"line_number":185,"context_line":"release notes easier because readers can get a quick summary of the change,"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_036e1a2f","line":182,"in_reply_to":"3a1ff146_004c5041","updated":"2017-03-15 14:05:08.000000000","message":"Done","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":11022,"name":"Rodrigo Duarte Sousa","email":"rodrigodsousa@gmail.com","username":"rodrigods"},"change_message_id":"9186aaf70a50262bb7f05ce8c1a1b4e67469f77a","unresolved":false,"context_lines":[{"line_number":178,"context_line":"    Created new notes file in releasenotes/notes/bug-1652012-7c53b9702b10084d.yaml"},{"line_number":179,"context_line":""},{"line_number":180,"context_line":"The body of the release note should clearly explain how the impact will affect"},{"line_number":181,"context_line":"users and operators. It should also detail why the change was necessary since"},{"line_number":182,"context_line":"how the change was implemented can be determined by looking into the commit. It"},{"line_number":183,"context_line":"should also contain a properly formatted link in reStructuredText that points"},{"line_number":184,"context_line":"back to the original bug report used to track the fix. This makes reading"},{"line_number":185,"context_line":"release notes easier because readers can get a quick summary of the change,"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_004c5041","line":182,"range":{"start_line":181,"start_character":72,"end_line":182,"end_character":76},"in_reply_to":"3a1ff146_795fab0e","updated":"2017-03-15 13:39:09.000000000","message":"++","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"979c25f7a8430c6c57bc2fb9dbfa2e3ff97b0ee1","unresolved":false,"context_lines":[{"line_number":179,"context_line":""},{"line_number":180,"context_line":"The body of the release note should clearly explain how the impact will affect"},{"line_number":181,"context_line":"users and operators. It should also detail why the change was necessary since"},{"line_number":182,"context_line":"how the change was implemented can be determined by looking into the commit. It"},{"line_number":183,"context_line":"should also contain a properly formatted link in reStructuredText that points"},{"line_number":184,"context_line":"back to the original bug report used to track the fix. This makes reading"},{"line_number":185,"context_line":"release notes easier because readers can get a quick summary of the change,"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_e3881eea","line":182,"in_reply_to":"3a1ff146_795fab0e","updated":"2017-03-15 14:05:08.000000000","message":"Done","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":18338,"name":"Ron De Rose","email":"ronald.de.rose@intel.com","username":"derosenet"},"change_message_id":"554399060797d1d72826d1eb4fee3bddd9a37337","unresolved":false,"context_lines":[{"line_number":180,"context_line":"The body of the release note should clearly explain how the impact will affect"},{"line_number":181,"context_line":"users and operators. It should also detail why the change was necessary since"},{"line_number":182,"context_line":"how the change was implemented can be determined by looking into the commit. It"},{"line_number":183,"context_line":"should also contain a properly formatted link in reStructuredText that points"},{"line_number":184,"context_line":"back to the original bug report used to track the fix. This makes reading"},{"line_number":185,"context_line":"release notes easier because readers can get a quick summary of the change,"},{"line_number":186,"context_line":"understand how it is going to impact them, and follow a link to more detail if"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_d9a41f0a","line":183,"range":{"start_line":183,"start_character":7,"end_line":183,"end_character":11},"updated":"2017-03-14 16:11:51.000000000","message":"remove \u0027also\u0027","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"979c25f7a8430c6c57bc2fb9dbfa2e3ff97b0ee1","unresolved":false,"context_lines":[{"line_number":180,"context_line":"The body of the release note should clearly explain how the impact will affect"},{"line_number":181,"context_line":"users and operators. It should also detail why the change was necessary since"},{"line_number":182,"context_line":"how the change was implemented can be determined by looking into the commit. It"},{"line_number":183,"context_line":"should also contain a properly formatted link in reStructuredText that points"},{"line_number":184,"context_line":"back to the original bug report used to track the fix. This makes reading"},{"line_number":185,"context_line":"release notes easier because readers can get a quick summary of the change,"},{"line_number":186,"context_line":"understand how it is going to impact them, and follow a link to more detail if"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_a3cc6636","line":183,"in_reply_to":"3a1ff146_605344e2","updated":"2017-03-15 14:05:08.000000000","message":"Done","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":11022,"name":"Rodrigo Duarte Sousa","email":"rodrigodsousa@gmail.com","username":"rodrigods"},"change_message_id":"9186aaf70a50262bb7f05ce8c1a1b4e67469f77a","unresolved":false,"context_lines":[{"line_number":180,"context_line":"The body of the release note should clearly explain how the impact will affect"},{"line_number":181,"context_line":"users and operators. It should also detail why the change was necessary since"},{"line_number":182,"context_line":"how the change was implemented can be determined by looking into the commit. It"},{"line_number":183,"context_line":"should also contain a properly formatted link in reStructuredText that points"},{"line_number":184,"context_line":"back to the original bug report used to track the fix. This makes reading"},{"line_number":185,"context_line":"release notes easier because readers can get a quick summary of the change,"},{"line_number":186,"context_line":"understand how it is going to impact them, and follow a link to more detail if"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_605344e2","line":183,"range":{"start_line":183,"start_character":7,"end_line":183,"end_character":11},"in_reply_to":"3a1ff146_d9a41f0a","updated":"2017-03-15 13:39:09.000000000","message":"++","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"979c25f7a8430c6c57bc2fb9dbfa2e3ff97b0ee1","unresolved":false,"context_lines":[{"line_number":180,"context_line":"The body of the release note should clearly explain how the impact will affect"},{"line_number":181,"context_line":"users and operators. It should also detail why the change was necessary since"},{"line_number":182,"context_line":"how the change was implemented can be determined by looking into the commit. It"},{"line_number":183,"context_line":"should also contain a properly formatted link in reStructuredText that points"},{"line_number":184,"context_line":"back to the original bug report used to track the fix. This makes reading"},{"line_number":185,"context_line":"release notes easier because readers can get a quick summary of the change,"},{"line_number":186,"context_line":"understand how it is going to impact them, and follow a link to more detail if"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_83c76a11","line":183,"in_reply_to":"3a1ff146_d9a41f0a","updated":"2017-03-15 14:05:08.000000000","message":"Done","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":11022,"name":"Rodrigo Duarte Sousa","email":"rodrigodsousa@gmail.com","username":"rodrigods"},"change_message_id":"9186aaf70a50262bb7f05ce8c1a1b4e67469f77a","unresolved":false,"context_lines":[{"line_number":184,"context_line":"back to the original bug report used to track the fix. This makes reading"},{"line_number":185,"context_line":"release notes easier because readers can get a quick summary of the change,"},{"line_number":186,"context_line":"understand how it is going to impact them, and follow a link to more detail if"},{"line_number":187,"context_line":"the choose."},{"line_number":188,"context_line":""},{"line_number":189,"context_line":".. code-block:: yaml"},{"line_number":190,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_00737081","line":187,"range":{"start_line":187,"start_character":0,"end_line":187,"end_character":3},"updated":"2017-03-15 13:39:09.000000000","message":"they","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"979c25f7a8430c6c57bc2fb9dbfa2e3ff97b0ee1","unresolved":false,"context_lines":[{"line_number":184,"context_line":"back to the original bug report used to track the fix. This makes reading"},{"line_number":185,"context_line":"release notes easier because readers can get a quick summary of the change,"},{"line_number":186,"context_line":"understand how it is going to impact them, and follow a link to more detail if"},{"line_number":187,"context_line":"the choose."},{"line_number":188,"context_line":""},{"line_number":189,"context_line":".. code-block:: yaml"},{"line_number":190,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_23d956f4","line":187,"in_reply_to":"3a1ff146_00737081","updated":"2017-03-15 14:05:08.000000000","message":"Done","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":11022,"name":"Rodrigo Duarte Sousa","email":"rodrigodsousa@gmail.com","username":"rodrigods"},"change_message_id":"9186aaf70a50262bb7f05ce8c1a1b4e67469f77a","unresolved":false,"context_lines":[{"line_number":198,"context_line":"        backwards compatability."},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"Release notes detailing feature work follow the same basic format, but instead"},{"line_number":201,"context_line":"of using the bug number in the name of the release note, use the blueprint URL"},{"line_number":202,"context_line":"slug used to track the feature work:"},{"line_number":203,"context_line":""},{"line_number":204,"context_line":".. code-block:: bash"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_00fa90bd","line":201,"range":{"start_line":201,"start_character":75,"end_line":201,"end_character":78},"updated":"2017-03-15 13:39:09.000000000","message":"ID? This is not quite the URL.","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"979c25f7a8430c6c57bc2fb9dbfa2e3ff97b0ee1","unresolved":false,"context_lines":[{"line_number":198,"context_line":"        backwards compatability."},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"Release notes detailing feature work follow the same basic format, but instead"},{"line_number":201,"context_line":"of using the bug number in the name of the release note, use the blueprint URL"},{"line_number":202,"context_line":"slug used to track the feature work:"},{"line_number":203,"context_line":""},{"line_number":204,"context_line":".. code-block:: bash"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_43fd7239","line":201,"in_reply_to":"3a1ff146_00fa90bd","updated":"2017-03-15 14:05:08.000000000","message":"I\u0027ll leave as slug for now, since that seems to be the best name I can come up with for this.","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":18338,"name":"Ron De Rose","email":"ronald.de.rose@intel.com","username":"derosenet"},"change_message_id":"554399060797d1d72826d1eb4fee3bddd9a37337","unresolved":false,"context_lines":[{"line_number":206,"context_line":"    $ reno new bp-support-fizzbangs"},{"line_number":207,"context_line":"    Created new notes file in releasenotes/notes/bp-support-fizzbangs-d8f6a3d81c2a465f.yaml"},{"line_number":208,"context_line":""},{"line_number":209,"context_line":"Just like for release notes communicating bug fixes, release notes detailing"},{"line_number":210,"context_line":"feature work must contain a link back to the blueprint. Readers should be able"},{"line_number":211,"context_line":"to easily discover all patches that implement the feature, as well as find"},{"line_number":212,"context_line":"links to the full specification and documentation. All of this is typically"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_d97b3f7a","line":209,"range":{"start_line":209,"start_character":0,"end_line":209,"end_character":13},"updated":"2017-03-14 16:11:51.000000000","message":"As with","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":11022,"name":"Rodrigo Duarte Sousa","email":"rodrigodsousa@gmail.com","username":"rodrigods"},"change_message_id":"9186aaf70a50262bb7f05ce8c1a1b4e67469f77a","unresolved":false,"context_lines":[{"line_number":206,"context_line":"    $ reno new bp-support-fizzbangs"},{"line_number":207,"context_line":"    Created new notes file in releasenotes/notes/bp-support-fizzbangs-d8f6a3d81c2a465f.yaml"},{"line_number":208,"context_line":""},{"line_number":209,"context_line":"Just like for release notes communicating bug fixes, release notes detailing"},{"line_number":210,"context_line":"feature work must contain a link back to the blueprint. Readers should be able"},{"line_number":211,"context_line":"to easily discover all patches that implement the feature, as well as find"},{"line_number":212,"context_line":"links to the full specification and documentation. All of this is typically"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_c026b867","line":209,"range":{"start_line":209,"start_character":10,"end_line":209,"end_character":13},"updated":"2017-03-15 13:39:09.000000000","message":"I would remove only \"for\"","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"979c25f7a8430c6c57bc2fb9dbfa2e3ff97b0ee1","unresolved":false,"context_lines":[{"line_number":206,"context_line":"    $ reno new bp-support-fizzbangs"},{"line_number":207,"context_line":"    Created new notes file in releasenotes/notes/bp-support-fizzbangs-d8f6a3d81c2a465f.yaml"},{"line_number":208,"context_line":""},{"line_number":209,"context_line":"Just like for release notes communicating bug fixes, release notes detailing"},{"line_number":210,"context_line":"feature work must contain a link back to the blueprint. Readers should be able"},{"line_number":211,"context_line":"to easily discover all patches that implement the feature, as well as find"},{"line_number":212,"context_line":"links to the full specification and documentation. All of this is typically"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_038a9abf","line":209,"in_reply_to":"3a1ff146_c026b867","updated":"2017-03-15 14:05:08.000000000","message":"Done","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":11022,"name":"Rodrigo Duarte Sousa","email":"rodrigodsousa@gmail.com","username":"rodrigods"},"change_message_id":"9186aaf70a50262bb7f05ce8c1a1b4e67469f77a","unresolved":false,"context_lines":[{"line_number":222,"context_line":""},{"line_number":223,"context_line":"In the rare case there is a release note that does not pertain to a bug or"},{"line_number":224,"context_line":"feature work, use a sensible slug and include any documentation relating to the"},{"line_number":225,"context_line":"note. We can iterate on the content and application of the release note in"},{"line_number":226,"context_line":"review."},{"line_number":227,"context_line":""},{"line_number":228,"context_line":"For more information on how and when to create release notes, see the"},{"line_number":229,"context_line":"`project-team-guide \u003chttps://docs.openstack.org/project-team-guide/release-management.html#how-to-add-new-release-notes\u003e`_."}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_40a008a0","line":226,"range":{"start_line":225,"start_character":72,"end_line":226,"end_character":6},"updated":"2017-03-15 13:39:09.000000000","message":"during the review process.","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":5046,"name":"Lance Bragstad","email":"lbragstad@redhat.com","username":"ldbragst"},"change_message_id":"979c25f7a8430c6c57bc2fb9dbfa2e3ff97b0ee1","unresolved":false,"context_lines":[{"line_number":223,"context_line":"In the rare case there is a release note that does not pertain to a bug or"},{"line_number":224,"context_line":"feature work, use a sensible slug and include any documentation relating to the"},{"line_number":225,"context_line":"note. We can iterate on the content and application of the release note in"},{"line_number":226,"context_line":"review."},{"line_number":227,"context_line":""},{"line_number":228,"context_line":"For more information on how and when to create release notes, see the"},{"line_number":229,"context_line":"`project-team-guide \u003chttps://docs.openstack.org/project-team-guide/release-management.html#how-to-add-new-release-notes\u003e`_."}],"source_content_type":"text/x-rst","patch_set":3,"id":"3a1ff146_a3c1c6e6","line":226,"in_reply_to":"3a1ff146_40a008a0","updated":"2017-03-15 14:05:08.000000000","message":"Done","commit_id":"71ecc4cf8fe4aaff359b0af8cad2d57274ca82fa"},{"author":{"_account_id":11022,"name":"Rodrigo Duarte Sousa","email":"rodrigodsousa@gmail.com","username":"rodrigods"},"change_message_id":"8f8aa4b953cfbc757a8f0f6330d32ecb7ce6ddd2","unresolved":false,"context_lines":[{"line_number":169,"context_line":""},{"line_number":170,"context_line":"Most release notes either describe bug fixes or announce support for new"},{"line_number":171,"context_line":"features, both of which are tracked using Launchpad. When creating a release"},{"line_number":172,"context_line":"note that communicates a bug fix, use the bug number in the name of the note:"},{"line_number":173,"context_line":""},{"line_number":174,"context_line":".. code-block:: bash"},{"line_number":175,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"3a1ff146_66527115","line":172,"range":{"start_line":172,"start_character":25,"end_line":172,"end_character":32},"updated":"2017-03-15 17:42:05.000000000","message":"nit: we use \"bug-fix\" and \"bug fix\", it is better to stick to one or another.","commit_id":"98433bbfc3a04e0bbe9042450eb4d21f72fe8f1b"}]}