)]}'
{"specs/newton/release-notes-guidelines-to-cg.rst":[{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"12eab032a18456118bdae4a1d99909818948cede","unresolved":false,"context_lines":[{"line_number":88,"context_line":"  why Community uses it to manage release notes."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"* Make a list of rn-related links in a form what-find-where."},{"line_number":91,"context_line":""},{"line_number":92,"context_line":"Dependencies"},{"line_number":93,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":94,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"3aaa91ec_dd927756","line":91,"updated":"2016-06-30 13:50:34.000000000","message":"* Add a reference to these guidelines at http://docs.openstack.org/project-team-guide/release-management.html#how-to-add-new-release-notes.","commit_id":"0b1c73bef14b121a21c11d9b5d7807fc8ccd0e78"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"9324915df2495b36ac310e16a02656c271a55f81","unresolved":false,"context_lines":[{"line_number":88,"context_line":"  why Community uses it to manage release notes."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"* Make a list of rn-related links in a form what-find-where."},{"line_number":91,"context_line":""},{"line_number":92,"context_line":"Dependencies"},{"line_number":93,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":94,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"3aaa91ec_0842ffad","line":91,"in_reply_to":"3aaa91ec_a87dab6e","updated":"2016-06-30 14:06:04.000000000","message":"Yup, sounds good. I also meant adding a cross-reference from Contributor guide to the Project team guide.","commit_id":"0b1c73bef14b121a21c11d9b5d7807fc8ccd0e78"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"6db94292570b495c48a752c97c459629178dd050","unresolved":false,"context_lines":[{"line_number":88,"context_line":"  why Community uses it to manage release notes."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"* Make a list of rn-related links in a form what-find-where."},{"line_number":91,"context_line":""},{"line_number":92,"context_line":"Dependencies"},{"line_number":93,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":94,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"3aaa91ec_a87dab6e","line":91,"in_reply_to":"3aaa91ec_dd927756","updated":"2016-06-30 13:59:24.000000000","message":"Thanks, Lena! I meant this in the last option - this link will be included in the list.","commit_id":"0b1c73bef14b121a21c11d9b5d7807fc8ccd0e78"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"da44ddbc94f7c52ba7b282034b9c89af9009f189","unresolved":false,"context_lines":[{"line_number":19,"context_line":"As a developer who creates the release notes for the OpenStack project"},{"line_number":20,"context_line":"I contribute to, I would like to have clear and concise writing style"},{"line_number":21,"context_line":"guidelines for the release notes as well as a handy list of all"},{"line_number":22,"context_line":"sources of information regarding the release notes management within"},{"line_number":23,"context_line":"the project."},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_12ebcab1","line":22,"range":{"start_line":22,"start_character":33,"end_line":22,"end_character":36},"updated":"2016-07-04 22:28:00.000000000","message":"remove \u0027the\u0027","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"c5a88742f20b5ff3283bb6eb8ccd505949af16f6","unresolved":false,"context_lines":[{"line_number":19,"context_line":"As a developer who creates the release notes for the OpenStack project"},{"line_number":20,"context_line":"I contribute to, I would like to have clear and concise writing style"},{"line_number":21,"context_line":"guidelines for the release notes as well as a handy list of all"},{"line_number":22,"context_line":"sources of information regarding the release notes management within"},{"line_number":23,"context_line":"the project."},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_fbf1b26b","line":22,"range":{"start_line":22,"start_character":33,"end_line":22,"end_character":36},"in_reply_to":"1aa78d24_12ebcab1","updated":"2016-07-05 06:20:57.000000000","message":"Done","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"da44ddbc94f7c52ba7b282034b9c89af9009f189","unresolved":false,"context_lines":[{"line_number":25,"context_line":"Proposed change"},{"line_number":26,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"The proposed changed is to add the following information to the Contributor"},{"line_number":29,"context_line":"guide:"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"* Release notes sections, what include where"}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_72d20e02","line":28,"range":{"start_line":28,"start_character":13,"end_line":28,"end_character":20},"updated":"2016-07-04 22:28:00.000000000","message":"change","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"c5a88742f20b5ff3283bb6eb8ccd505949af16f6","unresolved":false,"context_lines":[{"line_number":25,"context_line":"Proposed change"},{"line_number":26,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"The proposed changed is to add the following information to the Contributor"},{"line_number":29,"context_line":"guide:"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"* Release notes sections, what include where"}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_9b034e42","line":28,"range":{"start_line":28,"start_character":13,"end_line":28,"end_character":20},"in_reply_to":"1aa78d24_72d20e02","updated":"2016-07-05 06:20:57.000000000","message":"Done","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"da44ddbc94f7c52ba7b282034b9c89af9009f189","unresolved":false,"context_lines":[{"line_number":28,"context_line":"The proposed changed is to add the following information to the Contributor"},{"line_number":29,"context_line":"guide:"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"* Release notes sections, what include where"},{"line_number":32,"context_line":"* Writing style guidelines (verb forms, sentence structures, links inclusion,"},{"line_number":33,"context_line":"  etc.)"},{"line_number":34,"context_line":"* Release notes *bad -\u003e improved* examples"}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_52cd525c","line":31,"range":{"start_line":31,"start_character":26,"end_line":31,"end_character":44},"updated":"2016-07-04 22:28:00.000000000","message":"\u0027what is included where\u0027","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"c5a88742f20b5ff3283bb6eb8ccd505949af16f6","unresolved":false,"context_lines":[{"line_number":28,"context_line":"The proposed changed is to add the following information to the Contributor"},{"line_number":29,"context_line":"guide:"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"* Release notes sections, what include where"},{"line_number":32,"context_line":"* Writing style guidelines (verb forms, sentence structures, links inclusion,"},{"line_number":33,"context_line":"  etc.)"},{"line_number":34,"context_line":"* Release notes *bad -\u003e improved* examples"}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_1b963ef0","line":31,"range":{"start_line":31,"start_character":26,"end_line":31,"end_character":44},"in_reply_to":"1aa78d24_52cd525c","updated":"2016-07-05 06:20:57.000000000","message":"Done","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"da44ddbc94f7c52ba7b282034b9c89af9009f189","unresolved":false,"context_lines":[{"line_number":29,"context_line":"guide:"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"* Release notes sections, what include where"},{"line_number":32,"context_line":"* Writing style guidelines (verb forms, sentence structures, links inclusion,"},{"line_number":33,"context_line":"  etc.)"},{"line_number":34,"context_line":"* Release notes *bad -\u003e improved* examples"},{"line_number":35,"context_line":"* Reno overview for general understanding of how things work there."}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_f2043e7f","line":32,"range":{"start_line":32,"start_character":2,"end_line":32,"end_character":26},"updated":"2016-07-04 22:28:00.000000000","message":"Wouldn\u0027t this just refer back to the style guidelines already in the book? Be careful to avoid duplication here.","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"c5a88742f20b5ff3283bb6eb8ccd505949af16f6","unresolved":false,"context_lines":[{"line_number":29,"context_line":"guide:"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"* Release notes sections, what include where"},{"line_number":32,"context_line":"* Writing style guidelines (verb forms, sentence structures, links inclusion,"},{"line_number":33,"context_line":"  etc.)"},{"line_number":34,"context_line":"* Release notes *bad -\u003e improved* examples"},{"line_number":35,"context_line":"* Reno overview for general understanding of how things work there."}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_9614c544","line":32,"range":{"start_line":32,"start_character":2,"end_line":32,"end_character":26},"in_reply_to":"1aa78d24_f2043e7f","updated":"2016-07-05 06:20:57.000000000","message":"Release notes style should differ from other technical documentation, I\u0027ll try to reflect these differences avoiding duplications.","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"da44ddbc94f7c52ba7b282034b9c89af9009f189","unresolved":false,"context_lines":[{"line_number":33,"context_line":"  etc.)"},{"line_number":34,"context_line":"* Release notes *bad -\u003e improved* examples"},{"line_number":35,"context_line":"* Reno overview for general understanding of how things work there."},{"line_number":36,"context_line":"* The list of rn-related links shaped in a form what-find-where."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"Alternatives"},{"line_number":39,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_52f43286","line":36,"range":{"start_line":36,"start_character":31,"end_line":36,"end_character":63},"updated":"2016-07-04 22:28:00.000000000","message":"I don\u0027t understand what this means.","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"da44ddbc94f7c52ba7b282034b9c89af9009f189","unresolved":false,"context_lines":[{"line_number":33,"context_line":"  etc.)"},{"line_number":34,"context_line":"* Release notes *bad -\u003e improved* examples"},{"line_number":35,"context_line":"* Reno overview for general understanding of how things work there."},{"line_number":36,"context_line":"* The list of rn-related links shaped in a form what-find-where."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"Alternatives"},{"line_number":39,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_72f96e80","line":36,"range":{"start_line":36,"start_character":14,"end_line":36,"end_character":16},"updated":"2016-07-04 22:28:00.000000000","message":"spell this out.","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"c5a88742f20b5ff3283bb6eb8ccd505949af16f6","unresolved":false,"context_lines":[{"line_number":33,"context_line":"  etc.)"},{"line_number":34,"context_line":"* Release notes *bad -\u003e improved* examples"},{"line_number":35,"context_line":"* Reno overview for general understanding of how things work there."},{"line_number":36,"context_line":"* The list of rn-related links shaped in a form what-find-where."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"Alternatives"},{"line_number":39,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_365b5130","line":36,"range":{"start_line":36,"start_character":31,"end_line":36,"end_character":63},"in_reply_to":"1aa78d24_52f43286","updated":"2016-07-05 06:20:57.000000000","message":"Done","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"c5a88742f20b5ff3283bb6eb8ccd505949af16f6","unresolved":false,"context_lines":[{"line_number":33,"context_line":"  etc.)"},{"line_number":34,"context_line":"* Release notes *bad -\u003e improved* examples"},{"line_number":35,"context_line":"* Reno overview for general understanding of how things work there."},{"line_number":36,"context_line":"* The list of rn-related links shaped in a form what-find-where."},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"Alternatives"},{"line_number":39,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_9642053d","line":36,"range":{"start_line":36,"start_character":14,"end_line":36,"end_character":16},"in_reply_to":"1aa78d24_72f96e80","updated":"2016-07-05 06:20:57.000000000","message":"Done","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"da44ddbc94f7c52ba7b282034b9c89af9009f189","unresolved":false,"context_lines":[{"line_number":44,"context_line":""},{"line_number":45,"context_line":"Despite of the fact that these locations may fit (mainly because"},{"line_number":46,"context_line":"they are targeted at developers who create release notes for projects),"},{"line_number":47,"context_line":"there are strong arguments in favor of the Contributor guide, and they are"},{"line_number":48,"context_line":"as follows:"},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* *Project Team guide* mostly refers to procedures rather than to wording."},{"line_number":51,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_523b9238","line":48,"range":{"start_line":47,"start_character":60,"end_line":48,"end_character":10},"updated":"2016-07-04 22:28:00.000000000","message":"delete","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"c5a88742f20b5ff3283bb6eb8ccd505949af16f6","unresolved":false,"context_lines":[{"line_number":44,"context_line":""},{"line_number":45,"context_line":"Despite of the fact that these locations may fit (mainly because"},{"line_number":46,"context_line":"they are targeted at developers who create release notes for projects),"},{"line_number":47,"context_line":"there are strong arguments in favor of the Contributor guide, and they are"},{"line_number":48,"context_line":"as follows:"},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* *Project Team guide* mostly refers to procedures rather than to wording."},{"line_number":51,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"1aa78d24_16757597","line":48,"range":{"start_line":47,"start_character":60,"end_line":48,"end_character":10},"in_reply_to":"1aa78d24_523b9238","updated":"2016-07-05 06:20:57.000000000","message":"Done","commit_id":"8d99ff46a24f00aed55b8cc6511f60d0298c8948"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"5d286949ea89445e23429f9207a1605dfc0a5bc5","unresolved":false,"context_lines":[{"line_number":17,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"As a developer who creates the release notes for the OpenStack project"},{"line_number":20,"context_line":"I contribute to, I would like to have clear and concise writing style"},{"line_number":21,"context_line":"guidelines for the release notes as well as a handy list of all"},{"line_number":22,"context_line":"sources of information regarding release notes management within"},{"line_number":23,"context_line":"the project."},{"line_number":24,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"dada55a8_1dd77a24","line":21,"range":{"start_line":20,"start_character":48,"end_line":21,"end_character":10},"updated":"2016-07-22 21:16:19.000000000","message":"The guideline already exists: http://docs.openstack.org/contributor-guide/writing-style.html\nI think that the issue is that developers don\u0027t believe they need to follow it for release notes, which is clearly wrong. :)","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"023c33cc29f96b218cf384d1e69714529f6f748b","unresolved":false,"context_lines":[{"line_number":17,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"As a developer who creates the release notes for the OpenStack project"},{"line_number":20,"context_line":"I contribute to, I would like to have clear and concise writing style"},{"line_number":21,"context_line":"guidelines for the release notes as well as a handy list of all"},{"line_number":22,"context_line":"sources of information regarding release notes management within"},{"line_number":23,"context_line":"the project."},{"line_number":24,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_522cf649","line":21,"range":{"start_line":20,"start_character":48,"end_line":21,"end_character":10},"in_reply_to":"bacf61ea_42d601c4","updated":"2016-08-05 08:43:36.000000000","message":"Done","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"158652914f999ca7666f61f82fdecd5b4b0204fd","unresolved":false,"context_lines":[{"line_number":17,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"As a developer who creates the release notes for the OpenStack project"},{"line_number":20,"context_line":"I contribute to, I would like to have clear and concise writing style"},{"line_number":21,"context_line":"guidelines for the release notes as well as a handy list of all"},{"line_number":22,"context_line":"sources of information regarding release notes management within"},{"line_number":23,"context_line":"the project."},{"line_number":24,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_daadca89","line":21,"range":{"start_line":20,"start_character":48,"end_line":21,"end_character":10},"in_reply_to":"bacf61ea_4a27e8c9","updated":"2016-08-03 16:12:43.000000000","message":"Yes, sure, the style is a bit different. We just need to align recommendations, to make the rn consistent as much as possible.\nI can add an action item to the spec, something like - informing developers about the rn recommendations published to the Contributor guide :)","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"afd8dadb1f3fcbb79ec2f6031b7079dc2b8ad433","unresolved":false,"context_lines":[{"line_number":17,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"As a developer who creates the release notes for the OpenStack project"},{"line_number":20,"context_line":"I contribute to, I would like to have clear and concise writing style"},{"line_number":21,"context_line":"guidelines for the release notes as well as a handy list of all"},{"line_number":22,"context_line":"sources of information regarding release notes management within"},{"line_number":23,"context_line":"the project."},{"line_number":24,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_42d601c4","line":21,"range":{"start_line":20,"start_character":48,"end_line":21,"end_character":10},"in_reply_to":"bacf61ea_daadca89","updated":"2016-08-03 20:49:48.000000000","message":"Sounds good.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"59abab6c77d18de9dcca23e511fc560107b32f86","unresolved":false,"context_lines":[{"line_number":17,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"As a developer who creates the release notes for the OpenStack project"},{"line_number":20,"context_line":"I contribute to, I would like to have clear and concise writing style"},{"line_number":21,"context_line":"guidelines for the release notes as well as a handy list of all"},{"line_number":22,"context_line":"sources of information regarding release notes management within"},{"line_number":23,"context_line":"the project."},{"line_number":24,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_4a27e8c9","line":21,"range":{"start_line":20,"start_character":48,"end_line":21,"end_character":10},"in_reply_to":"dada55a8_1dd77a24","updated":"2016-07-31 23:33:51.000000000","message":"I think there are some specific things you could point out for release notes, the writing style is quite different to normal end-user writing. That said, we shouldn\u0027t be replicating what\u0027s already in the guide (just reference it back), and we also should make sure we advertise the guidelines to developers, especially around release time. Having this before Newton would be good!","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"5d286949ea89445e23429f9207a1605dfc0a5bc5","unresolved":false,"context_lines":[{"line_number":29,"context_line":"guide:"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"* Release notes sections, what is included where"},{"line_number":32,"context_line":"* Writing style guidelines (verb forms, sentence structures, links inclusion,"},{"line_number":33,"context_line":"  etc.)"},{"line_number":34,"context_line":"* Release notes *bad -\u003e improved* examples"},{"line_number":35,"context_line":"* Reno overview for general understanding of how things work there."},{"line_number":36,"context_line":"* The list of links where different pieces of release notes related"}],"source_content_type":"text/x-rst","patch_set":6,"id":"dada55a8_7dc956ac","line":33,"range":{"start_line":32,"start_character":2,"end_line":33,"end_character":7},"updated":"2016-07-22 21:16:19.000000000","message":"These should not be part of the release notes guidelines but rather the release note guidelines should link to the writing style guideline of OpenStack and obviously follow them.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"59abab6c77d18de9dcca23e511fc560107b32f86","unresolved":false,"context_lines":[{"line_number":29,"context_line":"guide:"},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"* Release notes sections, what is included where"},{"line_number":32,"context_line":"* Writing style guidelines (verb forms, sentence structures, links inclusion,"},{"line_number":33,"context_line":"  etc.)"},{"line_number":34,"context_line":"* Release notes *bad -\u003e improved* examples"},{"line_number":35,"context_line":"* Reno overview for general understanding of how things work there."},{"line_number":36,"context_line":"* The list of links where different pieces of release notes related"}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_6a2aac91","line":33,"range":{"start_line":32,"start_character":2,"end_line":33,"end_character":7},"in_reply_to":"dada55a8_7dc956ac","updated":"2016-07-31 23:33:51.000000000","message":"See my comments above.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"5d286949ea89445e23429f9207a1605dfc0a5bc5","unresolved":false,"context_lines":[{"line_number":32,"context_line":"* Writing style guidelines (verb forms, sentence structures, links inclusion,"},{"line_number":33,"context_line":"  etc.)"},{"line_number":34,"context_line":"* Release notes *bad -\u003e improved* examples"},{"line_number":35,"context_line":"* Reno overview for general understanding of how things work there."},{"line_number":36,"context_line":"* The list of links where different pieces of release notes related"},{"line_number":37,"context_line":"  information can be found (Reno docs, project team guide, etc)."},{"line_number":38,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"dada55a8_9d924a9e","line":35,"range":{"start_line":35,"start_character":2,"end_line":35,"end_character":67},"updated":"2016-07-22 21:16:19.000000000","message":"I would say rather, how to use reno to create guideline compliant release notes.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"fde5fc84fc7a10b6e8d5a95d11ec0beb40b2fcdf","unresolved":false,"context_lines":[{"line_number":32,"context_line":"* Writing style guidelines (verb forms, sentence structures, links inclusion,"},{"line_number":33,"context_line":"  etc.)"},{"line_number":34,"context_line":"* Release notes *bad -\u003e improved* examples"},{"line_number":35,"context_line":"* Reno overview for general understanding of how things work there."},{"line_number":36,"context_line":"* The list of links where different pieces of release notes related"},{"line_number":37,"context_line":"  information can be found (Reno docs, project team guide, etc)."},{"line_number":38,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_fb7bf078","line":35,"range":{"start_line":35,"start_character":2,"end_line":35,"end_character":67},"in_reply_to":"bacf61ea_ea14dc4d","updated":"2016-08-01 14:24:58.000000000","message":"The guideline would comply, not the devs.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"59abab6c77d18de9dcca23e511fc560107b32f86","unresolved":false,"context_lines":[{"line_number":32,"context_line":"* Writing style guidelines (verb forms, sentence structures, links inclusion,"},{"line_number":33,"context_line":"  etc.)"},{"line_number":34,"context_line":"* Release notes *bad -\u003e improved* examples"},{"line_number":35,"context_line":"* Reno overview for general understanding of how things work there."},{"line_number":36,"context_line":"* The list of links where different pieces of release notes related"},{"line_number":37,"context_line":"  information can be found (Reno docs, project team guide, etc)."},{"line_number":38,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_ea14dc4d","line":35,"range":{"start_line":35,"start_character":2,"end_line":35,"end_character":67},"in_reply_to":"dada55a8_9d924a9e","updated":"2016-07-31 23:33:51.000000000","message":"I suspect devs have no interest in being \u0027compliant\u0027 ;)","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"59abab6c77d18de9dcca23e511fc560107b32f86","unresolved":false,"context_lines":[{"line_number":41,"context_line":""},{"line_number":42,"context_line":"We can add these recommendations to the `Project Team guide \u003chttp://docs.openstack.org/project-team-guide/release-management.html\u003e`_,"},{"line_number":43,"context_line":"`Infra manual \u003chttp://docs.openstack.org/infra/manual/developers.html\u003e`_,"},{"line_number":44,"context_line":"or `Reno documentation \u003chttp://docs.openstack.org/developer/reno/\u003e`_."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"Despite of the fact that these locations may fit (mainly because"},{"line_number":47,"context_line":"they are targeted at developers who create release notes for projects),"}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_4a0ec83b","line":44,"range":{"start_line":44,"start_character":4,"end_line":44,"end_character":22},"updated":"2016-07-31 23:33:51.000000000","message":"We should definitely link to this from there, though.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"023c33cc29f96b218cf384d1e69714529f6f748b","unresolved":false,"context_lines":[{"line_number":41,"context_line":""},{"line_number":42,"context_line":"We can add these recommendations to the `Project Team guide \u003chttp://docs.openstack.org/project-team-guide/release-management.html\u003e`_,"},{"line_number":43,"context_line":"`Infra manual \u003chttp://docs.openstack.org/infra/manual/developers.html\u003e`_,"},{"line_number":44,"context_line":"or `Reno documentation \u003chttp://docs.openstack.org/developer/reno/\u003e`_."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"Despite of the fact that these locations may fit (mainly because"},{"line_number":47,"context_line":"they are targeted at developers who create release notes for projects),"}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_f2fecaac","line":44,"range":{"start_line":44,"start_character":4,"end_line":44,"end_character":22},"in_reply_to":"bacf61ea_4a0ec83b","updated":"2016-08-05 08:43:36.000000000","message":"Done","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"6d1c8038f8345c07a97963e6f96bc6e666d5967b","unresolved":false,"context_lines":[{"line_number":47,"context_line":"they are targeted at developers who create release notes for projects),"},{"line_number":48,"context_line":"there are strong arguments in favor of the Contributor guide:"},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* *Project Team guide* mostly refers to procedures rather than to wording."},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"* *Infra manual* contains only general workflow of contributing to"},{"line_number":53,"context_line":"  OpenStack source code repositories rather than specific use-cases such as"}],"source_content_type":"text/x-rst","patch_set":6,"id":"1aa78d24_0aa537a1","line":50,"updated":"2016-07-05 12:43:17.000000000","message":"It could be extended, right?\n\nWe already have 2 places people look for instructions for adding release notes. It seems more consumer-friendly to extend those than to add a third. Unless you\u0027re proposing that we remove the information from the project team guide?","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"59abab6c77d18de9dcca23e511fc560107b32f86","unresolved":false,"context_lines":[{"line_number":47,"context_line":"they are targeted at developers who create release notes for projects),"},{"line_number":48,"context_line":"there are strong arguments in favor of the Contributor guide:"},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* *Project Team guide* mostly refers to procedures rather than to wording."},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"* *Infra manual* contains only general workflow of contributing to"},{"line_number":53,"context_line":"  OpenStack source code repositories rather than specific use-cases such as"}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_6a010c06","line":50,"in_reply_to":"1aa78d24_0aa537a1","updated":"2016-07-31 23:33:51.000000000","message":"Doug, that\u0027s a good point, but this addition is more about writing guidelines than a Reno how-to, I think?","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"023c33cc29f96b218cf384d1e69714529f6f748b","unresolved":false,"context_lines":[{"line_number":47,"context_line":"they are targeted at developers who create release notes for projects),"},{"line_number":48,"context_line":"there are strong arguments in favor of the Contributor guide:"},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* *Project Team guide* mostly refers to procedures rather than to wording."},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"* *Infra manual* contains only general workflow of contributing to"},{"line_number":53,"context_line":"  OpenStack source code repositories rather than specific use-cases such as"}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_6d015f6a","line":50,"in_reply_to":"bacf61ea_26820f53","updated":"2016-08-05 08:43:36.000000000","message":"Done","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"158652914f999ca7666f61f82fdecd5b4b0204fd","unresolved":false,"context_lines":[{"line_number":47,"context_line":"they are targeted at developers who create release notes for projects),"},{"line_number":48,"context_line":"there are strong arguments in favor of the Contributor guide:"},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* *Project Team guide* mostly refers to procedures rather than to wording."},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"* *Infra manual* contains only general workflow of contributing to"},{"line_number":53,"context_line":"  OpenStack source code repositories rather than specific use-cases such as"}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_26820f53","line":50,"in_reply_to":"bacf61ea_6a010c06","updated":"2016-08-03 16:12:43.000000000","message":"Doug, Lana, I agree with both of you :), and that\u0027s why I put the project team guide here as an alternative solution.\nBut the project team guide provides the procedures of how to adjust a project repo to use reno. And the spec here is about the style of writing that should be used when creating the notes.\n\nWill the cross-referencing solve the problem?","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"6d1c8038f8345c07a97963e6f96bc6e666d5967b","unresolved":false,"context_lines":[{"line_number":56,"context_line":"* *Reno documentation* - though it is fully dedicated to the release notes"},{"line_number":57,"context_line":"  creation process and shaped for the developers (our main intended audience),"},{"line_number":58,"context_line":"  this is just a tool that can be replaced in future with another release"},{"line_number":59,"context_line":"  notes management tool with its own documentation."},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"To sum up, Contributor guide still remains the best place to document"},{"line_number":62,"context_line":"release notes style guidelines and to put together all sources of truth"}],"source_content_type":"text/x-rst","patch_set":6,"id":"1aa78d24_4aaf3f81","line":59,"updated":"2016-07-05 12:43:17.000000000","message":"reno is also not a good place to host project-specific instructions, because one of our goals is to have it used outside of OpenStack by other projects.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"5d286949ea89445e23429f9207a1605dfc0a5bc5","unresolved":false,"context_lines":[{"line_number":56,"context_line":"* *Reno documentation* - though it is fully dedicated to the release notes"},{"line_number":57,"context_line":"  creation process and shaped for the developers (our main intended audience),"},{"line_number":58,"context_line":"  this is just a tool that can be replaced in future with another release"},{"line_number":59,"context_line":"  notes management tool with its own documentation."},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"To sum up, Contributor guide still remains the best place to document"},{"line_number":62,"context_line":"release notes style guidelines and to put together all sources of truth"}],"source_content_type":"text/x-rst","patch_set":6,"id":"dada55a8_1d9f7ab5","line":59,"in_reply_to":"1aa78d24_4aaf3f81","updated":"2016-07-22 21:16:19.000000000","message":"I would say that reno would need to follow the guideline for release notes but I agree with Doug that the guideline should not be withing the reno documentation.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":2472,"name":"Doug Hellmann","email":"dhellmann@redhat.com","username":"doug-hellmann"},"change_message_id":"6d1c8038f8345c07a97963e6f96bc6e666d5967b","unresolved":false,"context_lines":[{"line_number":60,"context_line":""},{"line_number":61,"context_line":"To sum up, Contributor guide still remains the best place to document"},{"line_number":62,"context_line":"release notes style guidelines and to put together all sources of truth"},{"line_number":63,"context_line":"for the release notes creation."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"Implementation"},{"line_number":66,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":6,"id":"1aa78d24_0acc1769","line":63,"updated":"2016-07-05 12:43:17.000000000","message":"I\u0027m not sure what the contributor guide is. Is that a manual for contributors to all of openstack or is it a manual for contributors to the documentation?","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"5d286949ea89445e23429f9207a1605dfc0a5bc5","unresolved":false,"context_lines":[{"line_number":60,"context_line":""},{"line_number":61,"context_line":"To sum up, Contributor guide still remains the best place to document"},{"line_number":62,"context_line":"release notes style guidelines and to put together all sources of truth"},{"line_number":63,"context_line":"for the release notes creation."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"Implementation"},{"line_number":66,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":6,"id":"dada55a8_5d2452ae","line":63,"in_reply_to":"1aa78d24_0acc1769","updated":"2016-07-22 21:16:19.000000000","message":"It is the first. It is a manual for all contributions to OpenStack, including documentation.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"fde5fc84fc7a10b6e8d5a95d11ec0beb40b2fcdf","unresolved":false,"context_lines":[{"line_number":60,"context_line":""},{"line_number":61,"context_line":"To sum up, Contributor guide still remains the best place to document"},{"line_number":62,"context_line":"release notes style guidelines and to put together all sources of truth"},{"line_number":63,"context_line":"for the release notes creation."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"Implementation"},{"line_number":66,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_7b5540c4","line":63,"in_reply_to":"bacf61ea_2512a557","updated":"2016-08-01 14:24:58.000000000","message":"Agreed, but since developers are also documentation contributors, in this case, it would also apply to them.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"158652914f999ca7666f61f82fdecd5b4b0204fd","unresolved":false,"context_lines":[{"line_number":60,"context_line":""},{"line_number":61,"context_line":"To sum up, Contributor guide still remains the best place to document"},{"line_number":62,"context_line":"release notes style guidelines and to put together all sources of truth"},{"line_number":63,"context_line":"for the release notes creation."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"Implementation"},{"line_number":66,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_edd29a5a","line":63,"in_reply_to":"bacf61ea_7b5540c4","updated":"2016-08-03 16:12:43.000000000","message":"The title says \"OpenStack Documentation Contributor Guide\".\nSo, my understanding is that the CG is for people who contribute to docs, and rn are part of documentation.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"59abab6c77d18de9dcca23e511fc560107b32f86","unresolved":false,"context_lines":[{"line_number":60,"context_line":""},{"line_number":61,"context_line":"To sum up, Contributor guide still remains the best place to document"},{"line_number":62,"context_line":"release notes style guidelines and to put together all sources of truth"},{"line_number":63,"context_line":"for the release notes creation."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"Implementation"},{"line_number":66,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_2512a557","line":63,"in_reply_to":"dada55a8_5d2452ae","updated":"2016-07-31 23:33:51.000000000","message":"Rodrigo: not quite. It\u0027s all the things documentation contributors need to know above and beyond the Infra manual.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"5d286949ea89445e23429f9207a1605dfc0a5bc5","unresolved":false,"context_lines":[{"line_number":78,"context_line":""},{"line_number":79,"context_line":"* Create the overview of Release notes sections, what include where."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"* Develop the writing style guidelines (verb forms, sentence structures,"},{"line_number":82,"context_line":"  links inclusion, etc.)."},{"line_number":83,"context_line":""},{"line_number":84,"context_line":"* Make up bad examples of release notes and rework them."},{"line_number":85,"context_line":"  Present them in a form of *bad -\u003e improved* examples for better illustration."}],"source_content_type":"text/x-rst","patch_set":6,"id":"dada55a8_dd5162da","line":82,"range":{"start_line":81,"start_character":2,"end_line":82,"end_character":25},"updated":"2016-07-22 21:16:19.000000000","message":"The writing style guide already exists: http://docs.openstack.org/contributor-guide/writing-style.html","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"afd8dadb1f3fcbb79ec2f6031b7079dc2b8ad433","unresolved":false,"context_lines":[{"line_number":78,"context_line":""},{"line_number":79,"context_line":"* Create the overview of Release notes sections, what include where."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"* Develop the writing style guidelines (verb forms, sentence structures,"},{"line_number":82,"context_line":"  links inclusion, etc.)."},{"line_number":83,"context_line":""},{"line_number":84,"context_line":"* Make up bad examples of release notes and rework them."},{"line_number":85,"context_line":"  Present them in a form of *bad -\u003e improved* examples for better illustration."}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_3d3ccebe","line":82,"range":{"start_line":81,"start_character":2,"end_line":82,"end_character":25},"in_reply_to":"bacf61ea_818485b1","updated":"2016-08-03 20:49:48.000000000","message":"I agree that there are some release notes specific guidelines that certainly have their place here. However, the bulk of the writing style guidelines are already done. I think we are in agreement on this now, as long as it is understood that the original guideline is being exapnded upon and referenced.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"158652914f999ca7666f61f82fdecd5b4b0204fd","unresolved":false,"context_lines":[{"line_number":78,"context_line":""},{"line_number":79,"context_line":"* Create the overview of Release notes sections, what include where."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"* Develop the writing style guidelines (verb forms, sentence structures,"},{"line_number":82,"context_line":"  links inclusion, etc.)."},{"line_number":83,"context_line":""},{"line_number":84,"context_line":"* Make up bad examples of release notes and rework them."},{"line_number":85,"context_line":"  Present them in a form of *bad -\u003e improved* examples for better illustration."}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_818485b1","line":82,"range":{"start_line":81,"start_character":2,"end_line":82,"end_character":25},"in_reply_to":"dada55a8_dd5162da","updated":"2016-08-03 16:12:43.000000000","message":"Please see the comments to line 21. Release notes style is different from the user documentation one.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"5d286949ea89445e23429f9207a1605dfc0a5bc5","unresolved":false,"context_lines":[{"line_number":87,"context_line":"* Create Reno overview for general understanding of how things work there and"},{"line_number":88,"context_line":"  why Community uses it to manage release notes."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"* List links where different pieces of release notes related information"},{"line_number":91,"context_line":"  can be found."},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"* Add a reference to the Contributor Guide"},{"line_number":94,"context_line":"  at `Project Team guide \u003chttp://docs.openstack.org/project-team-guide/release-management.html#how-to-add-new-release-notes\u003e`__."}],"source_content_type":"text/x-rst","patch_set":6,"id":"dada55a8_fd0266b3","line":91,"range":{"start_line":90,"start_character":2,"end_line":91,"end_character":15},"updated":"2016-07-22 21:16:19.000000000","message":"I think it would be much better if you have a section called additional resources where you provide those links with brief descriptions.","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"023c33cc29f96b218cf384d1e69714529f6f748b","unresolved":false,"context_lines":[{"line_number":87,"context_line":"* Create Reno overview for general understanding of how things work there and"},{"line_number":88,"context_line":"  why Community uses it to manage release notes."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"* List links where different pieces of release notes related information"},{"line_number":91,"context_line":"  can be found."},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"* Add a reference to the Contributor Guide"},{"line_number":94,"context_line":"  at `Project Team guide \u003chttp://docs.openstack.org/project-team-guide/release-management.html#how-to-add-new-release-notes\u003e`__."}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_ad2197fe","line":91,"range":{"start_line":90,"start_character":2,"end_line":91,"end_character":15},"in_reply_to":"bacf61ea_e1810191","updated":"2016-08-05 08:43:36.000000000","message":"Done","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"158652914f999ca7666f61f82fdecd5b4b0204fd","unresolved":false,"context_lines":[{"line_number":87,"context_line":"* Create Reno overview for general understanding of how things work there and"},{"line_number":88,"context_line":"  why Community uses it to manage release notes."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"* List links where different pieces of release notes related information"},{"line_number":91,"context_line":"  can be found."},{"line_number":92,"context_line":""},{"line_number":93,"context_line":"* Add a reference to the Contributor Guide"},{"line_number":94,"context_line":"  at `Project Team guide \u003chttp://docs.openstack.org/project-team-guide/release-management.html#how-to-add-new-release-notes\u003e`__."}],"source_content_type":"text/x-rst","patch_set":6,"id":"bacf61ea_e1810191","line":91,"range":{"start_line":90,"start_character":2,"end_line":91,"end_character":15},"in_reply_to":"dada55a8_fd0266b3","updated":"2016-08-03 16:12:43.000000000","message":"Thanks, I\u0027ll update the description for better understanding. That\u0027s what I meant here when creating this work item :)","commit_id":"2a2a4a6f460c31795bbe1102952727aa4578f1b2"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"fca083981b14062b29e8c2ffce03b2095916832c","unresolved":false,"context_lines":[{"line_number":48,"context_line":"there are strong arguments in favor of the Contributor guide:"},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* *Project Team guide* mostly discusses adjusting a project\u0027s repo"},{"line_number":51,"context_line":"  to use the release management tool rather than to release notes writing"},{"line_number":52,"context_line":"  style."},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"* *Infra manual* contains only general workflow of contributing to"}],"source_content_type":"text/x-rst","patch_set":7,"id":"bacf61ea_83eb94db","line":51,"range":{"start_line":51,"start_character":49,"end_line":51,"end_character":51},"updated":"2016-08-05 03:19:04.000000000","message":"Just need to remove the \u0027to\u0027 here, I think.","commit_id":"edd4137cf5410c9c1c44dd20d9b5d1f661060a7e"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"a418b2b753b6e8afa731bcdcadb99df981db90fe","unresolved":false,"context_lines":[{"line_number":48,"context_line":"there are strong arguments in favor of the Contributor guide:"},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* *Project Team guide* mostly discusses adjusting a project\u0027s repo"},{"line_number":51,"context_line":"  to use the release management tool rather than to release notes writing"},{"line_number":52,"context_line":"  style."},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"* *Infra manual* contains only general workflow of contributing to"}],"source_content_type":"text/x-rst","patch_set":7,"id":"bacf61ea_25cf4557","line":51,"range":{"start_line":51,"start_character":49,"end_line":51,"end_character":51},"in_reply_to":"bacf61ea_83eb94db","updated":"2016-08-05 08:44:06.000000000","message":"Done","commit_id":"edd4137cf5410c9c1c44dd20d9b5d1f661060a7e"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"e2dc76fa2cb10e68516c9e4916b8229071c7d727","unresolved":false,"context_lines":[{"line_number":47,"context_line":"they are targeted at developers who create release notes for projects),"},{"line_number":48,"context_line":"there are strong arguments in favor of the Contributor guide:"},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* *Project Team guide* mostly discusses adjusting a project\u0027s repo"},{"line_number":51,"context_line":"  to use the release management tool rather than to release notes writing"},{"line_number":52,"context_line":"  style."},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"* *Infra manual* contains only general workflow of contributing to"},{"line_number":55,"context_line":"  OpenStack source code repositories rather than specific use-cases such as"}],"source_content_type":"text/x-rst","patch_set":7,"id":"bacf61ea_982325bd","line":52,"range":{"start_line":50,"start_character":30,"end_line":52,"end_character":8},"updated":"2016-08-04 12:59:29.000000000","message":"I cannot understand this sentence. I think a verb is missing.","commit_id":"edd4137cf5410c9c1c44dd20d9b5d1f661060a7e"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"a418b2b753b6e8afa731bcdcadb99df981db90fe","unresolved":false,"context_lines":[{"line_number":47,"context_line":"they are targeted at developers who create release notes for projects),"},{"line_number":48,"context_line":"there are strong arguments in favor of the Contributor guide:"},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"* *Project Team guide* mostly discusses adjusting a project\u0027s repo"},{"line_number":51,"context_line":"  to use the release management tool rather than to release notes writing"},{"line_number":52,"context_line":"  style."},{"line_number":53,"context_line":""},{"line_number":54,"context_line":"* *Infra manual* contains only general workflow of contributing to"},{"line_number":55,"context_line":"  OpenStack source code repositories rather than specific use-cases such as"}],"source_content_type":"text/x-rst","patch_set":7,"id":"bacf61ea_85d8b11f","line":52,"range":{"start_line":50,"start_character":30,"end_line":52,"end_character":8},"in_reply_to":"bacf61ea_982325bd","updated":"2016-08-05 08:44:06.000000000","message":"Done","commit_id":"edd4137cf5410c9c1c44dd20d9b5d1f661060a7e"}]}