)]}'
{"specs/pike/admin-guide-repos.rst":[{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"0d747256a39cd27908e813d5cabbb25d51c72d03","unresolved":false,"context_lines":[{"line_number":24,"context_line":"of these projects. We need to optimize our usage of the documentation team\u0027s"},{"line_number":25,"context_line":"limited resources."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Currently the administrator guide is in a seperate git repository from the"},{"line_number":28,"context_line":"code and patches being proposed.  This leads to an \"out of site, out of mind\""},{"line_number":29,"context_line":"scenario where updates to the administrator guide are an after thought if they"},{"line_number":30,"context_line":"get updated at all.  \"DocImpact\" bugs essentially throw the problem over the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_1031fd0b","line":27,"range":{"start_line":27,"start_character":42,"end_line":27,"end_character":65},"updated":"2017-03-01 11:47:37.000000000","message":"the guide does live in openstack-manuals as well, but the issue was more or less that dev projects are keeping THEIR individual admin content in the dev ref, rather than publishing it on docs.o.o to live in the guide.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"101d7c14deb76d88bbab34994386849a96a5244a","unresolved":false,"context_lines":[{"line_number":24,"context_line":"of these projects. We need to optimize our usage of the documentation team\u0027s"},{"line_number":25,"context_line":"limited resources."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Currently the administrator guide is in a seperate git repository from the"},{"line_number":28,"context_line":"code and patches being proposed.  This leads to an \"out of site, out of mind\""},{"line_number":29,"context_line":"scenario where updates to the administrator guide are an after thought if they"},{"line_number":30,"context_line":"get updated at all.  \"DocImpact\" bugs essentially throw the problem over the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_02ec348e","line":27,"range":{"start_line":27,"start_character":42,"end_line":27,"end_character":65},"in_reply_to":"ba2be162_1031fd0b","updated":"2017-03-02 00:08:37.000000000","message":"This a concern I have/had.  I can add a sentence about the other scenario as well.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Currently the administrator guide is in a seperate git repository from the"},{"line_number":28,"context_line":"code and patches being proposed.  This leads to an \"out of site, out of mind\""},{"line_number":29,"context_line":"scenario where updates to the administrator guide are an after thought if they"},{"line_number":30,"context_line":"get updated at all.  \"DocImpact\" bugs essentially throw the problem over the"},{"line_number":31,"context_line":"fence to the documentation team with little description of the required"},{"line_number":32,"context_line":"changes."}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_c88b1d1d","line":29,"range":{"start_line":29,"start_character":57,"end_line":29,"end_character":70},"updated":"2017-03-02 01:05:52.000000000","message":"afterthought","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Currently the administrator guide is in a seperate git repository from the"},{"line_number":28,"context_line":"code and patches being proposed.  This leads to an \"out of site, out of mind\""},{"line_number":29,"context_line":"scenario where updates to the administrator guide are an after thought if they"},{"line_number":30,"context_line":"get updated at all.  \"DocImpact\" bugs essentially throw the problem over the"},{"line_number":31,"context_line":"fence to the documentation team with little description of the required"},{"line_number":32,"context_line":"changes."}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_4ddb401b","line":29,"range":{"start_line":29,"start_character":57,"end_line":29,"end_character":70},"in_reply_to":"ba2be162_c88b1d1d","updated":"2017-03-11 00:28:26.000000000","message":"Done","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"0d747256a39cd27908e813d5cabbb25d51c72d03","unresolved":false,"context_lines":[{"line_number":27,"context_line":"Currently the administrator guide is in a seperate git repository from the"},{"line_number":28,"context_line":"code and patches being proposed.  This leads to an \"out of site, out of mind\""},{"line_number":29,"context_line":"scenario where updates to the administrator guide are an after thought if they"},{"line_number":30,"context_line":"get updated at all.  \"DocImpact\" bugs essentially throw the problem over the"},{"line_number":31,"context_line":"fence to the documentation team with little description of the required"},{"line_number":32,"context_line":"changes."},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_9025edc3","line":31,"range":{"start_line":30,"start_character":21,"end_line":31,"end_character":27},"updated":"2017-03-01 11:47:37.000000000","message":"Not sure if this is entirely related to this particular problem :) but it adds to it. We could probably remove this, as it\u0027s not a direct concern.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":27,"context_line":"Currently the administrator guide is in a seperate git repository from the"},{"line_number":28,"context_line":"code and patches being proposed.  This leads to an \"out of site, out of mind\""},{"line_number":29,"context_line":"scenario where updates to the administrator guide are an after thought if they"},{"line_number":30,"context_line":"get updated at all.  \"DocImpact\" bugs essentially throw the problem over the"},{"line_number":31,"context_line":"fence to the documentation team with little description of the required"},{"line_number":32,"context_line":"changes."},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_6dd644f2","line":31,"range":{"start_line":30,"start_character":21,"end_line":31,"end_character":27},"in_reply_to":"ba2be162_9025edc3","updated":"2017-03-11 00:28:26.000000000","message":"Done","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"101d7c14deb76d88bbab34994386849a96a5244a","unresolved":false,"context_lines":[{"line_number":27,"context_line":"Currently the administrator guide is in a seperate git repository from the"},{"line_number":28,"context_line":"code and patches being proposed.  This leads to an \"out of site, out of mind\""},{"line_number":29,"context_line":"scenario where updates to the administrator guide are an after thought if they"},{"line_number":30,"context_line":"get updated at all.  \"DocImpact\" bugs essentially throw the problem over the"},{"line_number":31,"context_line":"fence to the documentation team with little description of the required"},{"line_number":32,"context_line":"changes."},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"Proposed change"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_624fb0bd","line":31,"range":{"start_line":30,"start_character":21,"end_line":31,"end_character":27},"in_reply_to":"ba2be162_9025edc3","updated":"2017-03-02 00:08:37.000000000","message":"Ok, I thought this was a concern raised in the room.  I will remove it.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":36,"context_line":""},{"line_number":37,"context_line":"This specification proposes managing the administrator guide similar to the"},{"line_number":38,"context_line":"installation guide, where the administrator guide contents are stored in the"},{"line_number":39,"context_line":"project repository and are directly managed but the project team.  The"},{"line_number":40,"context_line":"documentation team would provide an editorial role for the contents of the"},{"line_number":41,"context_line":"administrator guide by posting patches to the guide contents in the project"},{"line_number":42,"context_line":"repositories.  This would allow for the continued consistent quality and voice"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_a8a189ab","line":39,"range":{"start_line":39,"start_character":44,"end_line":39,"end_character":47},"updated":"2017-03-02 01:05:52.000000000","message":"by","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":36,"context_line":""},{"line_number":37,"context_line":"This specification proposes managing the administrator guide similar to the"},{"line_number":38,"context_line":"installation guide, where the administrator guide contents are stored in the"},{"line_number":39,"context_line":"project repository and are directly managed but the project team.  The"},{"line_number":40,"context_line":"documentation team would provide an editorial role for the contents of the"},{"line_number":41,"context_line":"administrator guide by posting patches to the guide contents in the project"},{"line_number":42,"context_line":"repositories.  This would allow for the continued consistent quality and voice"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_8d07f880","line":39,"range":{"start_line":39,"start_character":44,"end_line":39,"end_character":47},"in_reply_to":"ba2be162_a8a189ab","updated":"2017-03-11 00:28:26.000000000","message":"Done","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":44,"context_line":""},{"line_number":45,"context_line":"Existing administrator guide content would be migrated to the designated"},{"line_number":46,"context_line":"project repositories. Project teams can decide which repository is appropriate"},{"line_number":47,"context_line":"for the content, for example neutron may choose openstack/neutron-lib. Inside"},{"line_number":48,"context_line":"these repositories the administrator guide content will be stored in a well"},{"line_number":49,"context_line":"known and consistent location, admin-guide/source. The current adminstrator"},{"line_number":50,"context_line":"guide is already laid out by service/project so this proposal should have"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_889be571","line":47,"range":{"start_line":47,"start_character":48,"end_line":47,"end_character":69},"updated":"2017-03-02 01:05:52.000000000","message":"the directory will need to be consistent across projects","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":44,"context_line":""},{"line_number":45,"context_line":"Existing administrator guide content would be migrated to the designated"},{"line_number":46,"context_line":"project repositories. Project teams can decide which repository is appropriate"},{"line_number":47,"context_line":"for the content, for example neutron may choose openstack/neutron-lib. Inside"},{"line_number":48,"context_line":"these repositories the administrator guide content will be stored in a well"},{"line_number":49,"context_line":"known and consistent location, admin-guide/source. The current adminstrator"},{"line_number":50,"context_line":"guide is already laid out by service/project so this proposal should have"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_ed007468","line":47,"range":{"start_line":47,"start_character":48,"end_line":47,"end_character":69},"in_reply_to":"ba2be162_889be571","updated":"2017-03-11 00:28:26.000000000","message":"Yes, defined in the next sentence.  I have clarified the punctuation.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":42,"context_line":"repositories.  This would allow for the continued consistent quality and voice"},{"line_number":43,"context_line":"of the guide."},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"Existing administrator guide content would be migrated to the designated"},{"line_number":46,"context_line":"project repositories. Project teams can decide which repository is appropriate"},{"line_number":47,"context_line":"for the content, for example neutron may choose openstack/neutron-lib. Inside"},{"line_number":48,"context_line":"these repositories the administrator guide content will be stored in a well"},{"line_number":49,"context_line":"known and consistent location, admin-guide/source. The current adminstrator"},{"line_number":50,"context_line":"guide is already laid out by service/project so this proposal should have"},{"line_number":51,"context_line":"minimal impact to the look and feel of the guide."},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"Ownership of the project specific administrator guides is with the"},{"line_number":54,"context_line":"respective project team, not the documentation team. This means the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_a8b6e9d9","line":51,"range":{"start_line":45,"start_character":0,"end_line":51,"end_character":49},"updated":"2017-03-02 01:05:52.000000000","message":"I would recommend we maintain a \u0027core\u0027 guide for the basic services (Nova, Cinder, Neutron, Keystone, etc) in the docs repo. This is in line with how we did the Install Guide, and it prevents us moving data around too much.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":57,"context_line":"the bug queue of the project."},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"The documentation team enables the project team to write the"},{"line_number":60,"context_line":"project specific guides with mentoring, setting up needed"},{"line_number":61,"context_line":"infrastructure, writing guidelines, provision of a template (\"cookie"},{"line_number":62,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":63,"context_line":"specific guides can use as reference."}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_88c0452c","line":60,"range":{"start_line":60,"start_character":0,"end_line":60,"end_character":38},"updated":"2017-03-02 01:05:52.000000000","message":"This is a big commit. The point of having project-specific guides is so we *don\u0027t* have to do that.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":57,"context_line":"the bug queue of the project."},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"The documentation team enables the project team to write the"},{"line_number":60,"context_line":"project specific guides with mentoring, setting up needed"},{"line_number":61,"context_line":"infrastructure, writing guidelines, provision of a template (\"cookie"},{"line_number":62,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":63,"context_line":"specific guides can use as reference."}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_ad311c5c","line":60,"range":{"start_line":60,"start_character":0,"end_line":60,"end_character":38},"in_reply_to":"ba2be162_88c0452c","updated":"2017-03-11 00:28:26.000000000","message":"This is word-for-word from the install guide spec we are cloning.  If this is not a capability of the documentation team any longer we can adjust this.\nhttps://github.com/openstack/docs-specs/blob/master/specs/newton/project-specific-installguides.rst#proposed-change","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":59,"context_line":"The documentation team enables the project team to write the"},{"line_number":60,"context_line":"project specific guides with mentoring, setting up needed"},{"line_number":61,"context_line":"infrastructure, writing guidelines, provision of a template (\"cookie"},{"line_number":62,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":63,"context_line":"specific guides can use as reference."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"The documentation team will select a list of priority projects for the release"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_48f48d86","line":62,"range":{"start_line":62,"start_character":26,"end_line":62,"end_character":58},"updated":"2017-03-02 01:05:52.000000000","message":"What is this?","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":59,"context_line":"The documentation team enables the project team to write the"},{"line_number":60,"context_line":"project specific guides with mentoring, setting up needed"},{"line_number":61,"context_line":"infrastructure, writing guidelines, provision of a template (\"cookie"},{"line_number":62,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":63,"context_line":"specific guides can use as reference."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"The documentation team will select a list of priority projects for the release"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_0d4308b3","line":62,"range":{"start_line":62,"start_character":26,"end_line":62,"end_character":58},"in_reply_to":"ba2be162_48f48d86","updated":"2017-03-11 00:28:26.000000000","message":"Again, from the install guide spec.\nAre you saying the documentation team would no longer have responsibility of the base document that the project documents plug into?  I thought that was a part you wanted to hang onto.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":8099,"name":"Graham Hayes","email":"gr@ham.ie","username":"graham"},"change_message_id":"e25c0b6f9ea9aff1b3744dfb30939ee50e0d5d6b","unresolved":false,"context_lines":[{"line_number":62,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":63,"context_line":"specific guides can use as reference."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":66,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":67,"context_line":"contents. This is similar to how the i18n team prioritizes projects for"},{"line_number":68,"context_line":"localization."}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_ccc42694","line":65,"updated":"2017-03-01 16:03:38.000000000","message":":) - I think having it as a flaoting list is a good idea. It may well be the \"base\" projects for the next while, but as the process matures, there may be more time availible for the docs team, and they can add / remove projects from this list.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"0d747256a39cd27908e813d5cabbb25d51c72d03","unresolved":false,"context_lines":[{"line_number":62,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":63,"context_line":"specific guides can use as reference."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":66,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":67,"context_line":"contents. This is similar to how the i18n team prioritizes projects for"},{"line_number":68,"context_line":"localization."}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_d60e7e33","line":65,"range":{"start_line":65,"start_character":45,"end_line":65,"end_character":62},"updated":"2017-03-01 11:47:37.000000000","message":"maybe just the \u0027base\u0027 projects like the install guide? Although that does the whole \u0027favouritism\u0027 thing again that I know bothers teams.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":8099,"name":"Graham Hayes","email":"gr@ham.ie","username":"graham"},"change_message_id":"d1bcf089e53bf598ff7b6a005a2102d39cbfe3f1","unresolved":false,"context_lines":[{"line_number":62,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":63,"context_line":"specific guides can use as reference."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":66,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":67,"context_line":"contents. This is similar to how the i18n team prioritizes projects for"},{"line_number":68,"context_line":"localization."}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_76ff6caa","line":65,"range":{"start_line":65,"start_character":45,"end_line":65,"end_character":62},"in_reply_to":"9a30ddce_24dce6e3","updated":"2017-03-08 13:21:10.000000000","message":"My recollection of the discussion in ATL was that all projects were going to get the content pushed to their repos, and the central admin guide would have a common intro, and them links to the content from the project repos.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":62,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":63,"context_line":"specific guides can use as reference."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":66,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":67,"context_line":"contents. This is similar to how the i18n team prioritizes projects for"},{"line_number":68,"context_line":"localization."}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_0d586887","line":65,"range":{"start_line":65,"start_character":45,"end_line":65,"end_character":62},"in_reply_to":"9a30ddce_76ff6caa","updated":"2017-03-11 00:28:26.000000000","message":"Right this was my recollection as well, but this section is about the idea of rotating through all of the content, over releases, to improve the quality.  It is not about taking ownership of content for non-\"base\" projects, but on a rotating basis helping teams that manage their own content.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"d86960f808f49cfbb09ec247a5ee5f19ac7ee4da","unresolved":false,"context_lines":[{"line_number":62,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":63,"context_line":"specific guides can use as reference."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":66,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":67,"context_line":"contents. This is similar to how the i18n team prioritizes projects for"},{"line_number":68,"context_line":"localization."}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_24dce6e3","line":65,"range":{"start_line":65,"start_character":45,"end_line":65,"end_character":62},"in_reply_to":"ba2be162_04ac038b","updated":"2017-03-08 10:28:01.000000000","message":"No, not at all. What we do is we maintain nova, neutron, keystone, horizon, cinder, and glance in our repository (this is simply to ensure at all times there *is* content on how to manage a base working cloud) and from there, we open up the opportunity for other projects (like Octavia :P) to add their content to the build. \nI know the Ironic stuff is woefully out of date, so that team won\u0027t exactly be devastated to see that go. But I\u0027m sure we could work with Telemetry and Orchestration to ensure their stuff goes back in. We have hte liaisons for that reason :)","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":62,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":63,"context_line":"specific guides can use as reference."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":66,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":67,"context_line":"contents. This is similar to how the i18n team prioritizes projects for"},{"line_number":68,"context_line":"localization."}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_8845a5b4","line":65,"range":{"start_line":65,"start_character":45,"end_line":65,"end_character":62},"in_reply_to":"ba2be162_42fe2c39","updated":"2017-03-02 01:05:52.000000000","message":"I would strongly recommend that we stick with the base projects: those things that you *must* have to have a basic, working PoC cloud (as we\u0027ve already defined for the Install Guide). Having different projects considered \u0027base\u0027 across different guides, or over time, is way too much overhead.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"7292869f47921a98447e1c9d57cfe355a88c473e","unresolved":false,"context_lines":[{"line_number":62,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":63,"context_line":"specific guides can use as reference."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":66,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":67,"context_line":"contents. This is similar to how the i18n team prioritizes projects for"},{"line_number":68,"context_line":"localization."}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_04ac038b","line":65,"range":{"start_line":65,"start_character":45,"end_line":65,"end_character":62},"in_reply_to":"ba2be162_8845a5b4","updated":"2017-03-07 22:54:55.000000000","message":"So you are going to ignore the other guide content?","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"101d7c14deb76d88bbab34994386849a96a5244a","unresolved":false,"context_lines":[{"line_number":62,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":63,"context_line":"specific guides can use as reference."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":66,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":67,"context_line":"contents. This is similar to how the i18n team prioritizes projects for"},{"line_number":68,"context_line":"localization."}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_027194e0","line":65,"in_reply_to":"ba2be162_ccc42694","updated":"2017-03-02 00:08:37.000000000","message":"I hope this is the case, that we can spread some docs attention beyond just a few projects on a rotating basis.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"101d7c14deb76d88bbab34994386849a96a5244a","unresolved":false,"context_lines":[{"line_number":62,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":63,"context_line":"specific guides can use as reference."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":66,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":67,"context_line":"contents. This is similar to how the i18n team prioritizes projects for"},{"line_number":68,"context_line":"localization."}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_42fe2c39","line":65,"range":{"start_line":65,"start_character":45,"end_line":65,"end_character":62},"in_reply_to":"ba2be162_d60e7e33","updated":"2017-03-02 00:08:37.000000000","message":"Is Octavia a \"base\" project?  Grin","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":63,"context_line":"specific guides can use as reference."},{"line_number":64,"context_line":""},{"line_number":65,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":66,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":67,"context_line":"contents. This is similar to how the i18n team prioritizes projects for"},{"line_number":68,"context_line":"localization."},{"line_number":69,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_4822cd02","line":66,"range":{"start_line":66,"start_character":23,"end_line":66,"end_character":44},"updated":"2017-03-02 01:05:52.000000000","message":"we have never done full reviews/testing of the admin guide. It\u0027s already tricky to get this done for the Install Guide, even with the reduced size of that guide.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":64,"context_line":""},{"line_number":65,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":66,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":67,"context_line":"contents. This is similar to how the i18n team prioritizes projects for"},{"line_number":68,"context_line":"localization."},{"line_number":69,"context_line":""},{"line_number":70,"context_line":"New gate jobs can be added to the project repositories that look for changes"},{"line_number":71,"context_line":"in the ^admin-guide/.* path on patch commits that open a docimpact style"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_682151fb","line":68,"range":{"start_line":67,"start_character":10,"end_line":68,"end_character":13},"updated":"2017-03-02 01:05:52.000000000","message":"How?","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":69,"context_line":""},{"line_number":70,"context_line":"New gate jobs can be added to the project repositories that look for changes"},{"line_number":71,"context_line":"in the ^admin-guide/.* path on patch commits that open a docimpact style"},{"line_number":72,"context_line":"bug for the docs team to provide an editorial review of the changes. Using"},{"line_number":73,"context_line":"this mechanism means that the bug will have a direct link to the patch that"},{"line_number":74,"context_line":"included changes to the administrator guide content."},{"line_number":75,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_e88381ca","line":72,"range":{"start_line":72,"start_character":8,"end_line":72,"end_character":68},"updated":"2017-03-02 01:05:52.000000000","message":"This sounds like going back to the bad old days of docimpact. How exactly would this work? Also, we haven\u0027t seen the need to do this for Install Guides, why is the Admin Guide different?","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":8099,"name":"Graham Hayes","email":"gr@ham.ie","username":"graham"},"change_message_id":"e25c0b6f9ea9aff1b3744dfb30939ee50e0d5d6b","unresolved":false,"context_lines":[{"line_number":71,"context_line":"in the ^admin-guide/.* path on patch commits that open a docimpact style"},{"line_number":72,"context_line":"bug for the docs team to provide an editorial review of the changes. Using"},{"line_number":73,"context_line":"this mechanism means that the bug will have a direct link to the patch that"},{"line_number":74,"context_line":"included changes to the administrator guide content."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"At patch commit and merge time, the admin-guide gate jobs can integrate the"},{"line_number":77,"context_line":"project based administrator guides by checking out the required repositories"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_ecc1ea81","line":74,"updated":"2017-03-01 16:03:38.000000000","message":"I would suggest we do something different for this:\n\nWe could set up a gerrit dashboard for the docs team that shows all changes in the admin guide (and api-ref, api-guide, install-guide etc)\n\neg searching for:\n\n  path:^api-ref/.* status:open NOT label:Code-Review\u003e-2,self\n\nwill give a list of patches across openstack that modify files in the api-ref, that I have not reviewed yet.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":71,"context_line":"in the ^admin-guide/.* path on patch commits that open a docimpact style"},{"line_number":72,"context_line":"bug for the docs team to provide an editorial review of the changes. Using"},{"line_number":73,"context_line":"this mechanism means that the bug will have a direct link to the patch that"},{"line_number":74,"context_line":"included changes to the administrator guide content."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"At patch commit and merge time, the admin-guide gate jobs can integrate the"},{"line_number":77,"context_line":"project based administrator guides by checking out the required repositories"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_cdb5707e","line":74,"in_reply_to":"9a30ddce_48dd8013","updated":"2017-03-11 00:28:26.000000000","message":"While I still think this is a great idea it might be too much change for this spec.  I will remove references to it.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"fccf65dc14b5a296f67987a244a8ae22c3fa0202","unresolved":false,"context_lines":[{"line_number":71,"context_line":"in the ^admin-guide/.* path on patch commits that open a docimpact style"},{"line_number":72,"context_line":"bug for the docs team to provide an editorial review of the changes. Using"},{"line_number":73,"context_line":"this mechanism means that the bug will have a direct link to the patch that"},{"line_number":74,"context_line":"included changes to the administrator guide content."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"At patch commit and merge time, the admin-guide gate jobs can integrate the"},{"line_number":77,"context_line":"project based administrator guides by checking out the required repositories"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_48dd8013","line":74,"in_reply_to":"9a30ddce_82ce9d81","updated":"2017-03-07 23:10:14.000000000","message":"The intent here is on commit, not patch sets.  It is an asynchronous workflow where a team could provide editorial support to recent changes in the documentation.\nThe workflow would look like this:\n1. Project team member develops a patch that includes a change to the admin-guide.\n2. The project team reviews the patch using the normal patch review process.\n3. When the patch is approved and starts the merge process we would have a job, similar to the translate jobs, that if the patch has changes to the admin-guide, it would open a bug for the editorial team, indicating the patch with the changes.\n4. At some point in the future an editorial team member could assign this bug to themselves and review the changes posted to the admin-guide.\n5. If the changes look fine, the editorial team member closed the bug.  If there are corrections required (voice, etc.) the editorial team member can propose a patch to the project with corrections.\n\nThe intent is to solve the \"docimpact\" bug situation discussed in the room (may not be valid from the comments here) that code changes in the project open a docimpact bug for the docs team with little guidance on the change and assumes the docs team knows what needs to be written. This would shift the responsibility for writing the content to the project team, but still empower the editorial team to maintain a level of quality in the docs.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"bec2488acb5856d6951ea44900be6094218dc8ea","unresolved":false,"context_lines":[{"line_number":71,"context_line":"in the ^admin-guide/.* path on patch commits that open a docimpact style"},{"line_number":72,"context_line":"bug for the docs team to provide an editorial review of the changes. Using"},{"line_number":73,"context_line":"this mechanism means that the bug will have a direct link to the patch that"},{"line_number":74,"context_line":"included changes to the administrator guide content."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"At patch commit and merge time, the admin-guide gate jobs can integrate the"},{"line_number":77,"context_line":"project based administrator guides by checking out the required repositories"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_82ce9d81","line":74,"in_reply_to":"ba2be162_c21bfc7e","updated":"2017-03-07 10:57:05.000000000","message":"Creating a bug at review time is something that is not done currently. Please discuss with infra team.\n\nReaction to bugs is not fast either, so I agree we should look at other workflows","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"101d7c14deb76d88bbab34994386849a96a5244a","unresolved":false,"context_lines":[{"line_number":71,"context_line":"in the ^admin-guide/.* path on patch commits that open a docimpact style"},{"line_number":72,"context_line":"bug for the docs team to provide an editorial review of the changes. Using"},{"line_number":73,"context_line":"this mechanism means that the bug will have a direct link to the patch that"},{"line_number":74,"context_line":"included changes to the administrator guide content."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"At patch commit and merge time, the admin-guide gate jobs can integrate the"},{"line_number":77,"context_line":"project based administrator guides by checking out the required repositories"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_c21bfc7e","line":74,"in_reply_to":"ba2be162_ecc1ea81","updated":"2017-03-02 00:08:37.000000000","message":"I worry that this would either slow down the patch review process while the core team waits for a docs review or the search would regularly miss commits.\nI was proposing the gate job/bug approach to make the editorial activity asynchronous and traceable.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":73,"context_line":"this mechanism means that the bug will have a direct link to the patch that"},{"line_number":74,"context_line":"included changes to the administrator guide content."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"At patch commit and merge time, the admin-guide gate jobs can integrate the"},{"line_number":77,"context_line":"project based administrator guides by checking out the required repositories"},{"line_number":78,"context_line":"and storing symbolic links in the main openstack-docs repository to each"},{"line_number":79,"context_line":"of the project\u0027s admin-guide/source directories."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"The administrator guide should be structured:"},{"line_number":82,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_8873e514","line":79,"range":{"start_line":76,"start_character":0,"end_line":79,"end_character":48},"updated":"2017-03-02 01:05:52.000000000","message":"This seems overly complicated.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":8099,"name":"Graham Hayes","email":"gr@ham.ie","username":"graham"},"change_message_id":"d1bcf089e53bf598ff7b6a005a2102d39cbfe3f1","unresolved":false,"context_lines":[{"line_number":73,"context_line":"this mechanism means that the bug will have a direct link to the patch that"},{"line_number":74,"context_line":"included changes to the administrator guide content."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"At patch commit and merge time, the admin-guide gate jobs can integrate the"},{"line_number":77,"context_line":"project based administrator guides by checking out the required repositories"},{"line_number":78,"context_line":"and storing symbolic links in the main openstack-docs repository to each"},{"line_number":79,"context_line":"of the project\u0027s admin-guide/source directories."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"The administrator guide should be structured:"},{"line_number":82,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_76720c4b","line":79,"range":{"start_line":76,"start_character":0,"end_line":79,"end_character":48},"in_reply_to":"9a30ddce_684fa492","updated":"2017-03-08 13:21:10.000000000","message":"I think we can just leverage the work done for the Install Guide / API Guide / API Ref.\n\nThis means we just have to maintain a list of projects that have admin guides, and as they are published to a known location, we do not need to worry about checking out other projects","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":73,"context_line":"this mechanism means that the bug will have a direct link to the patch that"},{"line_number":74,"context_line":"included changes to the administrator guide content."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"At patch commit and merge time, the admin-guide gate jobs can integrate the"},{"line_number":77,"context_line":"project based administrator guides by checking out the required repositories"},{"line_number":78,"context_line":"and storing symbolic links in the main openstack-docs repository to each"},{"line_number":79,"context_line":"of the project\u0027s admin-guide/source directories."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"The administrator guide should be structured:"},{"line_number":82,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_94cc60bc","line":79,"range":{"start_line":76,"start_character":0,"end_line":79,"end_character":48},"in_reply_to":"9a30ddce_76720c4b","updated":"2017-03-11 00:28:26.000000000","message":"Done","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"fccf65dc14b5a296f67987a244a8ae22c3fa0202","unresolved":false,"context_lines":[{"line_number":73,"context_line":"this mechanism means that the bug will have a direct link to the patch that"},{"line_number":74,"context_line":"included changes to the administrator guide content."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"At patch commit and merge time, the admin-guide gate jobs can integrate the"},{"line_number":77,"context_line":"project based administrator guides by checking out the required repositories"},{"line_number":78,"context_line":"and storing symbolic links in the main openstack-docs repository to each"},{"line_number":79,"context_line":"of the project\u0027s admin-guide/source directories."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"The administrator guide should be structured:"},{"line_number":82,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_0821c8fb","line":79,"range":{"start_line":76,"start_character":0,"end_line":79,"end_character":48},"in_reply_to":"9a30ddce_e29cb96b","updated":"2017-03-07 23:10:14.000000000","message":"In the work items below it was captured that a list of participating repos would have to be create/maintained.\nFrom the discussion in the room I thought this was how we are doing other distributed documentation such as the install guides/api-ref.  Am I wrong?","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"fccf65dc14b5a296f67987a244a8ae22c3fa0202","unresolved":false,"context_lines":[{"line_number":73,"context_line":"this mechanism means that the bug will have a direct link to the patch that"},{"line_number":74,"context_line":"included changes to the administrator guide content."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"At patch commit and merge time, the admin-guide gate jobs can integrate the"},{"line_number":77,"context_line":"project based administrator guides by checking out the required repositories"},{"line_number":78,"context_line":"and storing symbolic links in the main openstack-docs repository to each"},{"line_number":79,"context_line":"of the project\u0027s admin-guide/source directories."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"The administrator guide should be structured:"},{"line_number":82,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_684fa492","line":79,"range":{"start_line":76,"start_character":0,"end_line":79,"end_character":48},"in_reply_to":"ba2be162_8873e514","updated":"2017-03-07 23:10:14.000000000","message":"How so?\nWe always check out multiple repositories for devstack based tests.  Linking is as simple as git commit for symbolic links created locally.  The paths should all be in \"known\" locations.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"bec2488acb5856d6951ea44900be6094218dc8ea","unresolved":false,"context_lines":[{"line_number":73,"context_line":"this mechanism means that the bug will have a direct link to the patch that"},{"line_number":74,"context_line":"included changes to the administrator guide content."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"At patch commit and merge time, the admin-guide gate jobs can integrate the"},{"line_number":77,"context_line":"project based administrator guides by checking out the required repositories"},{"line_number":78,"context_line":"and storing symbolic links in the main openstack-docs repository to each"},{"line_number":79,"context_line":"of the project\u0027s admin-guide/source directories."},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"The administrator guide should be structured:"},{"line_number":82,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_e29cb96b","line":79,"range":{"start_line":76,"start_character":0,"end_line":79,"end_character":48},"in_reply_to":"ba2be162_8873e514","updated":"2017-03-07 10:57:05.000000000","message":"How will the jobs know which repos to check out?","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":8099,"name":"Graham Hayes","email":"gr@ham.ie","username":"graham"},"change_message_id":"e25c0b6f9ea9aff1b3744dfb30939ee50e0d5d6b","unresolved":false,"context_lines":[{"line_number":108,"context_line":""},{"line_number":109,"context_line":"1. Do nothing and attempt to maintain a centralized documentation repository."},{"line_number":110,"context_line":"2. Create a documentation repository for each project with shared core status."},{"line_number":111,"context_line":"3. Follow the proposed changes, but allow the documenation team core status."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"Implementation"},{"line_number":114,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_0cbf1efc","line":111,"updated":"2017-03-01 16:03:38.000000000","message":"I would actually be OK with #3 :) - but that may just be me.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"bec2488acb5856d6951ea44900be6094218dc8ea","unresolved":false,"context_lines":[{"line_number":108,"context_line":""},{"line_number":109,"context_line":"1. Do nothing and attempt to maintain a centralized documentation repository."},{"line_number":110,"context_line":"2. Create a documentation repository for each project with shared core status."},{"line_number":111,"context_line":"3. Follow the proposed changes, but allow the documenation team core status."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"Implementation"},{"line_number":114,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_22bb31c6","line":111,"range":{"start_line":111,"start_character":46,"end_line":111,"end_character":58},"updated":"2017-03-07 10:57:05.000000000","message":"typo: documentation","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"0d747256a39cd27908e813d5cabbb25d51c72d03","unresolved":false,"context_lines":[{"line_number":107,"context_line":"------------"},{"line_number":108,"context_line":""},{"line_number":109,"context_line":"1. Do nothing and attempt to maintain a centralized documentation repository."},{"line_number":110,"context_line":"2. Create a documentation repository for each project with shared core status."},{"line_number":111,"context_line":"3. Follow the proposed changes, but allow the documenation team core status."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"Implementation"},{"line_number":114,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_163f36b5","line":111,"range":{"start_line":110,"start_character":0,"end_line":111,"end_character":76},"updated":"2017-03-01 11:47:37.000000000","message":"ugh i dunno about these hey :(","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":108,"context_line":""},{"line_number":109,"context_line":"1. Do nothing and attempt to maintain a centralized documentation repository."},{"line_number":110,"context_line":"2. Create a documentation repository for each project with shared core status."},{"line_number":111,"context_line":"3. Follow the proposed changes, but allow the documenation team core status."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"Implementation"},{"line_number":114,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_7440cc07","line":111,"range":{"start_line":111,"start_character":46,"end_line":111,"end_character":58},"in_reply_to":"9a30ddce_22bb31c6","updated":"2017-03-11 00:28:26.000000000","message":"Done","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"101d7c14deb76d88bbab34994386849a96a5244a","unresolved":false,"context_lines":[{"line_number":107,"context_line":"------------"},{"line_number":108,"context_line":""},{"line_number":109,"context_line":"1. Do nothing and attempt to maintain a centralized documentation repository."},{"line_number":110,"context_line":"2. Create a documentation repository for each project with shared core status."},{"line_number":111,"context_line":"3. Follow the proposed changes, but allow the documenation team core status."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"Implementation"},{"line_number":114,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_4222ac02","line":111,"range":{"start_line":110,"start_character":0,"end_line":111,"end_character":76},"in_reply_to":"ba2be162_163f36b5","updated":"2017-03-02 00:08:37.000000000","message":"I was trying to capture alternatives I thought I heard in the room or on the etherpad.  I am ok removing them or correcting where I misunderstood.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":107,"context_line":"------------"},{"line_number":108,"context_line":""},{"line_number":109,"context_line":"1. Do nothing and attempt to maintain a centralized documentation repository."},{"line_number":110,"context_line":"2. Create a documentation repository for each project with shared core status."},{"line_number":111,"context_line":"3. Follow the proposed changes, but allow the documenation team core status."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"Implementation"},{"line_number":114,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_e85aa182","line":111,"range":{"start_line":110,"start_character":0,"end_line":111,"end_character":76},"in_reply_to":"ba2be162_4222ac02","updated":"2017-03-02 01:05:52.000000000","message":"Meh, they\u0027re alternatives. The whole point is we *don\u0027t* like them :P","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"0d747256a39cd27908e813d5cabbb25d51c72d03","unresolved":false,"context_lines":[{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Assignee(s)"},{"line_number":117,"context_line":"-----------"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":""},{"line_number":120,"context_line":"Work Items"},{"line_number":121,"context_line":"----------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_76823254","line":118,"updated":"2017-03-01 11:47:37.000000000","message":"* Alexandra Settle (asettle)\n* Joseph Robinson (jrobinson_)\n* Michael Johnson? :D\n* Ildiko Vancsa (ildikov)","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Assignee(s)"},{"line_number":117,"context_line":"-----------"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":""},{"line_number":120,"context_line":"Work Items"},{"line_number":121,"context_line":"----------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_884a05ab","line":118,"in_reply_to":"ba2be162_76823254","updated":"2017-03-02 01:05:52.000000000","message":"+ Entire docs team\n+ Infra/tools","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Assignee(s)"},{"line_number":117,"context_line":"-----------"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":""},{"line_number":120,"context_line":"Work Items"},{"line_number":121,"context_line":"----------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_9459c037","line":118,"in_reply_to":"ba2be162_884a05ab","updated":"2017-03-11 00:28:26.000000000","message":"I\u0027m not sure who constitutes the whole docs team, so feel free to provide a list or update the spec.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":120,"context_line":"Work Items"},{"line_number":121,"context_line":"----------"},{"line_number":122,"context_line":"* Setup admin-guide folders in the appropriate project repositories."},{"line_number":123,"context_line":"* Move existing content from the central administrator guide into the per"},{"line_number":124,"context_line":"  project repositories."},{"line_number":125,"context_line":"* Create the list of repositories that will be required to render the guide."},{"line_number":126,"context_line":"* Setup gate jobs to open \"docimpact\" style bugs on ^admin-guide/.* commits."},{"line_number":127,"context_line":"* Setup gate jobs to render the administrator guide on patch upload and merge."}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_c8ca3d1a","line":124,"range":{"start_line":123,"start_character":2,"end_line":124,"end_character":23},"updated":"2017-03-02 01:05:52.000000000","message":"Yeah, still not convinced.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":122,"context_line":"* Setup admin-guide folders in the appropriate project repositories."},{"line_number":123,"context_line":"* Move existing content from the central administrator guide into the per"},{"line_number":124,"context_line":"  project repositories."},{"line_number":125,"context_line":"* Create the list of repositories that will be required to render the guide."},{"line_number":126,"context_line":"* Setup gate jobs to open \"docimpact\" style bugs on ^admin-guide/.* commits."},{"line_number":127,"context_line":"* Setup gate jobs to render the administrator guide on patch upload and merge."},{"line_number":128,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_08d535b8","line":125,"range":{"start_line":125,"start_character":2,"end_line":125,"end_character":76},"updated":"2017-03-02 01:05:52.000000000","message":"This will be done by individual projects using the cookiecutter as they decide to create a guide. We don\u0027t need to do it ahead of time.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":122,"context_line":"* Setup admin-guide folders in the appropriate project repositories."},{"line_number":123,"context_line":"* Move existing content from the central administrator guide into the per"},{"line_number":124,"context_line":"  project repositories."},{"line_number":125,"context_line":"* Create the list of repositories that will be required to render the guide."},{"line_number":126,"context_line":"* Setup gate jobs to open \"docimpact\" style bugs on ^admin-guide/.* commits."},{"line_number":127,"context_line":"* Setup gate jobs to render the administrator guide on patch upload and merge."},{"line_number":128,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_d4497832","line":125,"range":{"start_line":125,"start_character":2,"end_line":125,"end_character":76},"in_reply_to":"ba2be162_08d535b8","updated":"2017-03-11 00:28:26.000000000","message":"Done","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"0d747256a39cd27908e813d5cabbb25d51c72d03","unresolved":false,"context_lines":[{"line_number":123,"context_line":"* Move existing content from the central administrator guide into the per"},{"line_number":124,"context_line":"  project repositories."},{"line_number":125,"context_line":"* Create the list of repositories that will be required to render the guide."},{"line_number":126,"context_line":"* Setup gate jobs to open \"docimpact\" style bugs on ^admin-guide/.* commits."},{"line_number":127,"context_line":"* Setup gate jobs to render the administrator guide on patch upload and merge."},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"Dependencies"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_d6cf5eae","line":126,"range":{"start_line":126,"start_character":26,"end_line":126,"end_character":76},"updated":"2017-03-01 11:47:37.000000000","message":"Oh - I missed this. I don\u0027t know understand how you propose this one works?\n\nI was mostly proposing we use it similarly to the install guide (see my link below)","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":123,"context_line":"* Move existing content from the central administrator guide into the per"},{"line_number":124,"context_line":"  project repositories."},{"line_number":125,"context_line":"* Create the list of repositories that will be required to render the guide."},{"line_number":126,"context_line":"* Setup gate jobs to open \"docimpact\" style bugs on ^admin-guide/.* commits."},{"line_number":127,"context_line":"* Setup gate jobs to render the administrator guide on patch upload and merge."},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"Dependencies"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_5464a8b7","line":126,"range":{"start_line":126,"start_character":26,"end_line":126,"end_character":76},"in_reply_to":"ba2be162_65917a99","updated":"2017-03-11 00:28:26.000000000","message":"Removed based on the discussion above.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"101d7c14deb76d88bbab34994386849a96a5244a","unresolved":false,"context_lines":[{"line_number":123,"context_line":"* Move existing content from the central administrator guide into the per"},{"line_number":124,"context_line":"  project repositories."},{"line_number":125,"context_line":"* Create the list of repositories that will be required to render the guide."},{"line_number":126,"context_line":"* Setup gate jobs to open \"docimpact\" style bugs on ^admin-guide/.* commits."},{"line_number":127,"context_line":"* Setup gate jobs to render the administrator guide on patch upload and merge."},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"Dependencies"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_65917a99","line":126,"range":{"start_line":126,"start_character":26,"end_line":126,"end_character":76},"in_reply_to":"ba2be162_d6cf5eae","updated":"2017-03-02 00:08:37.000000000","message":"This is what I was proposing above on line 70.  It is something new that I hoped would make reviewing/managing this content easier.  This is not for docimpact bugs to write content, but for editorial review of content the project team has committed to their admin guide content.\nThis probably needs re-worded.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"0d747256a39cd27908e813d5cabbb25d51c72d03","unresolved":false,"context_lines":[{"line_number":125,"context_line":"* Create the list of repositories that will be required to render the guide."},{"line_number":126,"context_line":"* Setup gate jobs to open \"docimpact\" style bugs on ^admin-guide/.* commits."},{"line_number":127,"context_line":"* Setup gate jobs to render the administrator guide on patch upload and merge."},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"Dependencies"},{"line_number":130,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":131,"context_line":"* This model implies that the administrator guide and the participating"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_d6467e22","line":128,"updated":"2017-03-01 11:47:37.000000000","message":"* Update contributor guide with instructions similar to install and deploy guide (https://docs.openstack.org/contributor-guide/project-guides.html)","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":125,"context_line":"* Create the list of repositories that will be required to render the guide."},{"line_number":126,"context_line":"* Setup gate jobs to open \"docimpact\" style bugs on ^admin-guide/.* commits."},{"line_number":127,"context_line":"* Setup gate jobs to render the administrator guide on patch upload and merge."},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"Dependencies"},{"line_number":130,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":131,"context_line":"* This model implies that the administrator guide and the participating"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_88e1259d","line":128,"in_reply_to":"ba2be162_d6467e22","updated":"2017-03-02 01:05:52.000000000","message":"+1","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":125,"context_line":"* Create the list of repositories that will be required to render the guide."},{"line_number":126,"context_line":"* Setup gate jobs to open \"docimpact\" style bugs on ^admin-guide/.* commits."},{"line_number":127,"context_line":"* Setup gate jobs to render the administrator guide on patch upload and merge."},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"Dependencies"},{"line_number":130,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":131,"context_line":"* This model implies that the administrator guide and the participating"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_7457ecc9","line":128,"in_reply_to":"ba2be162_d6467e22","updated":"2017-03-11 00:28:26.000000000","message":"Done","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"030980926bc687dca63316763c2591e6811c8ef7","unresolved":false,"context_lines":[{"line_number":128,"context_line":""},{"line_number":129,"context_line":"Dependencies"},{"line_number":130,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":131,"context_line":"* This model implies that the administrator guide and the participating"},{"line_number":132,"context_line":"  projects are using stable branches such that release specific guides are"},{"line_number":133,"context_line":"  available."},{"line_number":134,"context_line":""},{"line_number":135,"context_line":"Testing"},{"line_number":136,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ba2be162_e8e8e17e","line":133,"range":{"start_line":131,"start_character":2,"end_line":133,"end_character":12},"updated":"2017-03-02 01:05:52.000000000","message":"We don\u0027t currently version the Admin Guide. Are you suggesting we should?","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"8ded355972bc25d01dbb8830034cc1aafa250ba5","unresolved":false,"context_lines":[{"line_number":128,"context_line":""},{"line_number":129,"context_line":"Dependencies"},{"line_number":130,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":131,"context_line":"* This model implies that the administrator guide and the participating"},{"line_number":132,"context_line":"  projects are using stable branches such that release specific guides are"},{"line_number":133,"context_line":"  available."},{"line_number":134,"context_line":""},{"line_number":135,"context_line":"Testing"},{"line_number":136,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a30ddce_945aa0f0","line":133,"range":{"start_line":131,"start_character":2,"end_line":133,"end_character":12},"in_reply_to":"ba2be162_e8e8e17e","updated":"2017-03-11 00:28:26.000000000","message":"Removed\nI think there might be a reason to version the admin guide, but that should be out of scope for this specification.","commit_id":"1512a36dfd7f12e88db901269d688400ceddc768"},{"author":{"_account_id":19779,"name":"Chason Chan","display_name":"chenxing","email":"chason.chan@foxmail.com","username":"chenxing"},"change_message_id":"4bcf74b69ddf086f66e2b6078c25893f16614b94","unresolved":false,"context_lines":[{"line_number":37,"context_line":"project repository and are directly managed by the project team.  The"},{"line_number":38,"context_line":"documentation team would provide an editorial role for the contents of the"},{"line_number":39,"context_line":"administrator guide by posting patches to the guide contents in the project"},{"line_number":40,"context_line":"repositories.  This would allow for the continued consistent quality and voice"},{"line_number":41,"context_line":"of the guide."},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"Existing administrator guide content would be migrated to the designated"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a30ddce_77560e07","line":40,"range":{"start_line":40,"start_character":13,"end_line":40,"end_character":15},"updated":"2017-03-11 01:42:05.000000000","message":"One space is enough.","commit_id":"21e85da185fbde540c64713b7650ac963e782df6"},{"author":{"_account_id":19779,"name":"Chason Chan","display_name":"chenxing","email":"chason.chan@foxmail.com","username":"chenxing"},"change_message_id":"4bcf74b69ddf086f66e2b6078c25893f16614b94","unresolved":false,"context_lines":[{"line_number":44,"context_line":"project repositories. Project teams can decide which repository is appropriate"},{"line_number":45,"context_line":"for the content, for example neutron may choose openstack/neutron-lib. Inside"},{"line_number":46,"context_line":"these repositories the administrator guide content will be stored in a well"},{"line_number":47,"context_line":"known and consistent location: admin-guide/source. The current adminstrator"},{"line_number":48,"context_line":"guide is already laid out by service/project so this proposal should have"},{"line_number":49,"context_line":"minimal impact to the look and feel of the guide."},{"line_number":50,"context_line":""}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a30ddce_d7389ad5","line":47,"range":{"start_line":47,"start_character":63,"end_line":47,"end_character":75},"updated":"2017-03-11 01:42:05.000000000","message":"administrator*","commit_id":"21e85da185fbde540c64713b7650ac963e782df6"},{"author":{"_account_id":19779,"name":"Chason Chan","display_name":"chenxing","email":"chason.chan@foxmail.com","username":"chenxing"},"change_message_id":"4bcf74b69ddf086f66e2b6078c25893f16614b94","unresolved":false,"context_lines":[{"line_number":115,"context_line":""},{"line_number":116,"context_line":"Work Items"},{"line_number":117,"context_line":"----------"},{"line_number":118,"context_line":"* Setup cookiecutter for the adminstrator guide."},{"line_number":119,"context_line":"* Encourage the project teams to move their existing content into their"},{"line_number":120,"context_line":"  project repository."},{"line_number":121,"context_line":"* Update the master index file to reflect the new structure."}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a30ddce_771fee5a","line":118,"range":{"start_line":118,"start_character":29,"end_line":118,"end_character":41},"updated":"2017-03-11 01:42:05.000000000","message":"administrator*","commit_id":"21e85da185fbde540c64713b7650ac963e782df6"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"f2b09144c12b05737c25732fe3b1e8cf38c51d28","unresolved":false,"context_lines":[{"line_number":34,"context_line":""},{"line_number":35,"context_line":"This specification proposes managing the administrator guide similar to the"},{"line_number":36,"context_line":"installation guide, where the administrator guide contents are stored in the"},{"line_number":37,"context_line":"project repository and are directly managed by the project team.  The"},{"line_number":38,"context_line":"documentation team would provide an editorial role for the contents of the"},{"line_number":39,"context_line":"administrator guide by posting patches to the guide contents in the project"},{"line_number":40,"context_line":"repositories. This would allow for the continued consistent quality and voice"},{"line_number":41,"context_line":"of the guide."},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"Existing administrator guide content would be migrated to the designated"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a30ddce_877a5d22","line":40,"range":{"start_line":37,"start_character":66,"end_line":40,"end_character":13},"updated":"2017-03-13 10:14:03.000000000","message":"note that this is not done for current installation guide (noting the \"similar\" above)","commit_id":"352b3800abbd7bd5c4c615916a47954ef65c8a90"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"c1578f26ebbf0239211893c6ade4c48d6c8cebf8","unresolved":false,"context_lines":[{"line_number":34,"context_line":""},{"line_number":35,"context_line":"This specification proposes managing the administrator guide similar to the"},{"line_number":36,"context_line":"installation guide, where the administrator guide contents are stored in the"},{"line_number":37,"context_line":"project repository and are directly managed by the project team.  The"},{"line_number":38,"context_line":"documentation team would provide an editorial role for the contents of the"},{"line_number":39,"context_line":"administrator guide by posting patches to the guide contents in the project"},{"line_number":40,"context_line":"repositories. This would allow for the continued consistent quality and voice"},{"line_number":41,"context_line":"of the guide."},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"Existing administrator guide content would be migrated to the designated"}],"source_content_type":"text/x-rst","patch_set":6,"id":"1a1ced50_66f25ed4","line":40,"range":{"start_line":37,"start_character":66,"end_line":40,"end_character":13},"in_reply_to":"9a30ddce_877a5d22","updated":"2017-03-20 09:37:12.000000000","message":"Would that make sense to phrase it in a way like \u0027the documentation team can continue providing an editorial role for the ...\u0027?","commit_id":"352b3800abbd7bd5c4c615916a47954ef65c8a90"},{"author":{"_account_id":10897,"name":"Joseph Robinson","email":"josephremail@gmail.com","username":"RobiJoe"},"change_message_id":"8ae975cf2563a2339cd3fe193d59502687d68a8b","unresolved":false,"context_lines":[{"line_number":61,"context_line":"specific guides can use as reference."},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":64,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":65,"context_line":"contents for those selected projects. This is similar to how the i18n team"},{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a30ddce_2fd6ed4e","line":64,"updated":"2017-03-13 07:27:58.000000000","message":"Some of these proposed items could be work items in the Work Items section. Specifically the writing guidelines and working base administrator guide.","commit_id":"352b3800abbd7bd5c4c615916a47954ef65c8a90"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"79a3d2a847016e3416c1d95ad59d5896629b7d11","unresolved":false,"context_lines":[{"line_number":61,"context_line":"specific guides can use as reference."},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":64,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":65,"context_line":"contents for those selected projects. This is similar to how the i18n team"},{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a30ddce_07374dff","line":64,"in_reply_to":"9a30ddce_2fd6ed4e","updated":"2017-03-13 10:29:26.000000000","message":"+1 yes good suggestion","commit_id":"352b3800abbd7bd5c4c615916a47954ef65c8a90"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"f2b09144c12b05737c25732fe3b1e8cf38c51d28","unresolved":false,"context_lines":[{"line_number":82,"context_line":"    Administrator Guide"},{"line_number":83,"context_line":"    \u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":84,"context_line":"        .. toctree::"},{"line_number":85,"context_line":"            compute/index.rst"},{"line_number":86,"context_line":"            networking/index.rst"},{"line_number":87,"context_line":"            ..."},{"line_number":88,"context_line":""},{"line_number":89,"context_line":"    [nova/admin-guide/source/index.rst]"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a30ddce_a7c3e136","line":86,"range":{"start_line":85,"start_character":0,"end_line":86,"end_character":32},"updated":"2017-03-13 10:14:03.000000000","message":"this does not mirror the installation guide.","commit_id":"352b3800abbd7bd5c4c615916a47954ef65c8a90"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"79a3d2a847016e3416c1d95ad59d5896629b7d11","unresolved":false,"context_lines":[{"line_number":82,"context_line":"    Administrator Guide"},{"line_number":83,"context_line":"    \u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":84,"context_line":"        .. toctree::"},{"line_number":85,"context_line":"            compute/index.rst"},{"line_number":86,"context_line":"            networking/index.rst"},{"line_number":87,"context_line":"            ..."},{"line_number":88,"context_line":""},{"line_number":89,"context_line":"    [nova/admin-guide/source/index.rst]"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a30ddce_9ab8f02b","line":86,"range":{"start_line":85,"start_character":0,"end_line":86,"end_character":32},"in_reply_to":"9a30ddce_a7c3e136","updated":"2017-03-13 10:29:26.000000000","message":"Yes, I think it would be best if we used the exact same methods. We have it set up already and we know what we would need to do.\nhttps://docs.openstack.org/contributor-guide/project-guides.html","commit_id":"352b3800abbd7bd5c4c615916a47954ef65c8a90"},{"author":{"_account_id":8099,"name":"Graham Hayes","email":"gr@ham.ie","username":"graham"},"change_message_id":"a6e4cf34bc5284344ebef127c79ec72f9d3debab","unresolved":false,"context_lines":[{"line_number":119,"context_line":"Work Items"},{"line_number":120,"context_line":"----------"},{"line_number":121,"context_line":"* Setup cookiecutter for the adminstrator guide."},{"line_number":122,"context_line":"* Encourage the project teams to move their existing content into their"},{"line_number":123,"context_line":"  project repository."},{"line_number":124,"context_line":"* Update the master index file to reflect the new structure."},{"line_number":125,"context_line":"* Setup gate jobs to publish the administrator guide on patch merge."}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a30ddce_fa1d6c73","line":122,"updated":"2017-03-13 10:49:03.000000000","message":"I would change this to \"move existing content to project teams repos.","commit_id":"352b3800abbd7bd5c4c615916a47954ef65c8a90"},{"author":{"_account_id":10897,"name":"Joseph Robinson","email":"josephremail@gmail.com","username":"RobiJoe"},"change_message_id":"8ae975cf2563a2339cd3fe193d59502687d68a8b","unresolved":false,"context_lines":[{"line_number":123,"context_line":"  project repository."},{"line_number":124,"context_line":"* Update the master index file to reflect the new structure."},{"line_number":125,"context_line":"* Setup gate jobs to publish the administrator guide on patch merge."},{"line_number":126,"context_line":"* Update the Documentation Contributor Guide to include the required steps"},{"line_number":127,"context_line":"  to setup a project administrator guide."},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"Dependencies"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a30ddce_4f408107","line":126,"updated":"2017-03-13 07:27:58.000000000","message":"add an additional part to this sentence, specifying the work items mentioned in the preceding paragraphs: \", and to include a working base administrator guide for reference purposes\"","commit_id":"352b3800abbd7bd5c4c615916a47954ef65c8a90"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"f2b09144c12b05737c25732fe3b1e8cf38c51d28","unresolved":false,"context_lines":[{"line_number":125,"context_line":"* Setup gate jobs to publish the administrator guide on patch merge."},{"line_number":126,"context_line":"* Update the Documentation Contributor Guide to include the required steps"},{"line_number":127,"context_line":"  to setup a project administrator guide."},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"Dependencies"},{"line_number":130,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":131,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a30ddce_a7da0115","line":128,"updated":"2017-03-13 10:14:03.000000000","message":"also: Tell project teams about this so that they can start their own guides and create *new* content.","commit_id":"352b3800abbd7bd5c4c615916a47954ef65c8a90"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"38e6430f7a34742431d70ad9d07d4f1c3779cd29","unresolved":false,"context_lines":[{"line_number":40,"context_line":"project repositories. This would allow for the continued consistent quality"},{"line_number":41,"context_line":"and voice of the guide."},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"Existing administrator guide content would be migrated to the designated"},{"line_number":44,"context_line":"project repositories. Project teams can decide which repository is appropriate"},{"line_number":45,"context_line":"for the content, for example neutron may choose openstack/neutron-lib. Inside"},{"line_number":46,"context_line":"these repositories the administrator guide content will be stored in a well"},{"line_number":47,"context_line":"known and consistent location: admin-guide/source. The current administrator"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_995e3d42","line":44,"range":{"start_line":43,"start_character":0,"end_line":44,"end_character":21},"updated":"2017-04-04 21:58:41.000000000","message":"Should your reference go here?","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"9fef8a9498dc23d75f7b66edb5180787b782cc09","unresolved":false,"context_lines":[{"line_number":55,"context_line":"the bug queue of the project."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"The documentation team enables the project team to write the"},{"line_number":58,"context_line":"project specific guides with mentoring, setting up needed"},{"line_number":59,"context_line":"infrastructure, writing guidelines, provision of a template (\"cookie"},{"line_number":60,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":61,"context_line":"specific guides can use as reference."}],"source_content_type":"text/x-rst","patch_set":7,"id":"ffe62b97_16ac709e","line":58,"range":{"start_line":58,"start_character":8,"end_line":58,"end_character":39},"updated":"2017-03-27 09:52:14.000000000","message":"I wonder - is this too vague? Or do we think this is suitable?","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"b8ad02dc6cd23994f8724378a00cf338cf28c8a0","unresolved":false,"context_lines":[{"line_number":55,"context_line":"the bug queue of the project."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"The documentation team enables the project team to write the"},{"line_number":58,"context_line":"project specific guides with mentoring, setting up needed"},{"line_number":59,"context_line":"infrastructure, writing guidelines, provision of a template (\"cookie"},{"line_number":60,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":61,"context_line":"specific guides can use as reference."}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_7b6a68b3","line":58,"range":{"start_line":58,"start_character":8,"end_line":58,"end_character":39},"in_reply_to":"dfeb2761_03c2e0e9","updated":"2017-04-04 10:40:14.000000000","message":"Good point","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"38e6430f7a34742431d70ad9d07d4f1c3779cd29","unresolved":false,"context_lines":[{"line_number":55,"context_line":"the bug queue of the project."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"The documentation team enables the project team to write the"},{"line_number":58,"context_line":"project specific guides with mentoring, setting up needed"},{"line_number":59,"context_line":"infrastructure, writing guidelines, provision of a template (\"cookie"},{"line_number":60,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":61,"context_line":"specific guides can use as reference."}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_4e7b49bd","line":58,"range":{"start_line":58,"start_character":8,"end_line":58,"end_character":39},"in_reply_to":"dfeb2761_7b6a68b3","updated":"2017-04-04 21:58:41.000000000","message":"I take it as answering questions as they come up from project teams and providing guidance.  I would not expect a formal mentoring situation where projects are paired with documentation team members.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"bfe9c06eba74b2142575d250bf936d059a13f0a7","unresolved":false,"context_lines":[{"line_number":55,"context_line":"the bug queue of the project."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"The documentation team enables the project team to write the"},{"line_number":58,"context_line":"project specific guides with mentoring, setting up needed"},{"line_number":59,"context_line":"infrastructure, writing guidelines, provision of a template (\"cookie"},{"line_number":60,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":61,"context_line":"specific guides can use as reference."}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_03c2e0e9","line":58,"range":{"start_line":58,"start_character":8,"end_line":58,"end_character":39},"in_reply_to":"dfeb2761_83795030","updated":"2017-04-04 00:43:27.000000000","message":"No, I think it\u0027s fine as-is. It all depends on how you define \u0027mentoring\u0027 but it\u0027s not like this is a legal document ;)","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b074da5676382341b7446b1cb99dc7a903669548","unresolved":false,"context_lines":[{"line_number":55,"context_line":"the bug queue of the project."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"The documentation team enables the project team to write the"},{"line_number":58,"context_line":"project specific guides with mentoring, setting up needed"},{"line_number":59,"context_line":"infrastructure, writing guidelines, provision of a template (\"cookie"},{"line_number":60,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":61,"context_line":"specific guides can use as reference."}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_83795030","line":58,"range":{"start_line":58,"start_character":8,"end_line":58,"end_character":39},"in_reply_to":"ffe62b97_16ac709e","updated":"2017-04-04 00:23:00.000000000","message":"I borrowed this from the install guide spec.  Should I say \"project specific administrator guide\" or was the mentoring part too vague?","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"9af23d9e11df7d3350906560b5dad307be4cb891","unresolved":false,"context_lines":[{"line_number":60,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":61,"context_line":"specific guides can use as reference."},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":64,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":65,"context_line":"contents for those selected projects. This is similar to how the i18n team"},{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"To publish the project\u0027s administrator guide, the project will implement a tox"},{"line_number":69,"context_line":"target to build the guide, similar to the one created for the installation"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ffe62b97_ebe133fe","line":66,"range":{"start_line":63,"start_character":0,"end_line":66,"end_character":38},"updated":"2017-03-27 00:06:57.000000000","message":"I want this to specify the base guides, to marry with the Install Guide model:\n\nCompute service (nova): Part of starter-kit:compute.\nImage service (glance): Part of starter-kit:compute.\nIdentity service (keystone): Part of starter-kit:compute.\nNetworking service (neutron): Part of starter-kit:compute.\nBlock storage service (cinder): Part of current install guide and expected by most users.\nDashboard (horizon): Part of current install guide and expected by most users.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"bfe9c06eba74b2142575d250bf936d059a13f0a7","unresolved":false,"context_lines":[{"line_number":60,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":61,"context_line":"specific guides can use as reference."},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":64,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":65,"context_line":"contents for those selected projects. This is similar to how the i18n team"},{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"To publish the project\u0027s administrator guide, the project will implement a tox"},{"line_number":69,"context_line":"target to build the guide, similar to the one created for the installation"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_835b9052","line":66,"range":{"start_line":63,"start_character":0,"end_line":66,"end_character":38},"in_reply_to":"dfeb2761_63788c29","updated":"2017-04-04 00:43:27.000000000","message":"I understand the ideological stance here, but I don\u0027t think it helps us implement the project by not mentioning specifics. At some point, specific guides will have to be discussed, and the spec is the place for that.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"b8ad02dc6cd23994f8724378a00cf338cf28c8a0","unresolved":false,"context_lines":[{"line_number":60,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":61,"context_line":"specific guides can use as reference."},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":64,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":65,"context_line":"contents for those selected projects. This is similar to how the i18n team"},{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"To publish the project\u0027s administrator guide, the project will implement a tox"},{"line_number":69,"context_line":"target to build the guide, similar to the one created for the installation"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_dbe054cf","line":66,"range":{"start_line":63,"start_character":0,"end_line":66,"end_character":38},"in_reply_to":"dfeb2761_835b9052","updated":"2017-04-04 10:40:14.000000000","message":"What Lana said - we need something to branch off, like we did with the install guide. But, again, this isn\u0027t a legal document - just a specification. We can definitely elaborate later and try different methods.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"38e6430f7a34742431d70ad9d07d4f1c3779cd29","unresolved":false,"context_lines":[{"line_number":60,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":61,"context_line":"specific guides can use as reference."},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":64,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":65,"context_line":"contents for those selected projects. This is similar to how the i18n team"},{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"To publish the project\u0027s administrator guide, the project will implement a tox"},{"line_number":69,"context_line":"target to build the guide, similar to the one created for the installation"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_f406701c","line":66,"range":{"start_line":63,"start_character":0,"end_line":66,"end_character":38},"in_reply_to":"dfeb2761_dbe054cf","updated":"2017-04-04 21:58:41.000000000","message":"In the above paragraphs we talk about the base guide (not project specific content).  Is that what we are talking about here?  Maybe I am mis-interpreting your list of projects.  Are you trying to say these projects will still get special treatment and should not move (as was listed above?  See my comment/marker.\nI\u0027m going to post an update.  Let\u0027s keep talking about this on the next version.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"daf706a3ca120fc1718a47066ca7f53e393f9052","unresolved":false,"context_lines":[{"line_number":60,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":61,"context_line":"specific guides can use as reference."},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":64,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":65,"context_line":"contents for those selected projects. This is similar to how the i18n team"},{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"To publish the project\u0027s administrator guide, the project will implement a tox"},{"line_number":69,"context_line":"target to build the guide, similar to the one created for the installation"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_0723d6be","line":66,"range":{"start_line":63,"start_character":0,"end_line":66,"end_character":38},"in_reply_to":"dfeb2761_f406701c","updated":"2017-04-05 09:08:39.000000000","message":"Hey Michael - so, yes. What is considered a \u0027base\u0027 (or starter-kit) is the projects we\u0027re talking about above. We single them out *only* because they are generally what the community uses when they deploy a cloud. Now, of course, each case is different, but the docs team uses the \u0027base\u0027 as a way to ensure that each user and operator always has maintained docs. Similar to how we use the install guide - which is why we\u0027re quite insistent on the similarities in the specs","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b074da5676382341b7446b1cb99dc7a903669548","unresolved":false,"context_lines":[{"line_number":60,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":61,"context_line":"specific guides can use as reference."},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":64,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":65,"context_line":"contents for those selected projects. This is similar to how the i18n team"},{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"To publish the project\u0027s administrator guide, the project will implement a tox"},{"line_number":69,"context_line":"target to build the guide, similar to the one created for the installation"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_63788c29","line":66,"range":{"start_line":63,"start_character":0,"end_line":66,"end_character":38},"in_reply_to":"ffe62b97_ebe133fe","updated":"2017-04-04 00:23:00.000000000","message":"Actually I am really uncomfortable with that.  I do not want a spec I author to perpetuate the have/have-not situation.  The whole point of this paragraph was to propose a system that could better service projects other than those you listed in a scalable way.\n\nI am willing to compromise here and just remove this paragraph.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"9fef8a9498dc23d75f7b66edb5180787b782cc09","unresolved":false,"context_lines":[{"line_number":60,"context_line":"cutter\"), and providing a working base administrator guide that the project"},{"line_number":61,"context_line":"specific guides can use as reference."},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"The documentation team will select a list of priority projects for the release"},{"line_number":64,"context_line":"series that will get a full review and scrub of the administrator guide"},{"line_number":65,"context_line":"contents for those selected projects. This is similar to how the i18n team"},{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"To publish the project\u0027s administrator guide, the project will implement a tox"},{"line_number":69,"context_line":"target to build the guide, similar to the one created for the installation"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ffe62b97_b6902450","line":66,"range":{"start_line":63,"start_character":0,"end_line":66,"end_character":38},"in_reply_to":"ffe62b97_ebe133fe","updated":"2017-03-27 09:52:14.000000000","message":"Yep, +1 - makes sense :)","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"9fef8a9498dc23d75f7b66edb5180787b782cc09","unresolved":false,"context_lines":[{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"To publish the project\u0027s administrator guide, the project will implement a tox"},{"line_number":69,"context_line":"target to build the guide, similar to the one created for the installation"},{"line_number":70,"context_line":"guides. A gate job template \u0027admin-guide-jobs\u0027 will be added to the project"},{"line_number":71,"context_line":"including the service name.  This will cause the administration guide to be"},{"line_number":72,"context_line":"published when updates are merged."},{"line_number":73,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"ffe62b97_568b181e","line":70,"range":{"start_line":69,"start_character":46,"end_line":70,"end_character":6},"updated":"2017-03-27 09:52:14.000000000","message":"Maybe a link to the install guide spec would be helpful here.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"bfe9c06eba74b2142575d250bf936d059a13f0a7","unresolved":false,"context_lines":[{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"To publish the project\u0027s administrator guide, the project will implement a tox"},{"line_number":69,"context_line":"target to build the guide, similar to the one created for the installation"},{"line_number":70,"context_line":"guides. A gate job template \u0027admin-guide-jobs\u0027 will be added to the project"},{"line_number":71,"context_line":"including the service name.  This will cause the administration guide to be"},{"line_number":72,"context_line":"published when updates are merged."},{"line_number":73,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_23328411","line":70,"range":{"start_line":69,"start_character":46,"end_line":70,"end_character":6},"in_reply_to":"dfeb2761_03930051","updated":"2017-04-04 00:43:27.000000000","message":"I think keeping it in the references is fine. Maybe just add a (see References) or something here.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"38e6430f7a34742431d70ad9d07d4f1c3779cd29","unresolved":false,"context_lines":[{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"To publish the project\u0027s administrator guide, the project will implement a tox"},{"line_number":69,"context_line":"target to build the guide, similar to the one created for the installation"},{"line_number":70,"context_line":"guides. A gate job template \u0027admin-guide-jobs\u0027 will be added to the project"},{"line_number":71,"context_line":"including the service name.  This will cause the administration guide to be"},{"line_number":72,"context_line":"published when updates are merged."},{"line_number":73,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_ce02b96f","line":70,"range":{"start_line":69,"start_character":46,"end_line":70,"end_character":6},"in_reply_to":"dfeb2761_23328411","updated":"2017-04-04 21:58:41.000000000","message":"Done","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"b8ad02dc6cd23994f8724378a00cf338cf28c8a0","unresolved":false,"context_lines":[{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"To publish the project\u0027s administrator guide, the project will implement a tox"},{"line_number":69,"context_line":"target to build the guide, similar to the one created for the installation"},{"line_number":70,"context_line":"guides. A gate job template \u0027admin-guide-jobs\u0027 will be added to the project"},{"line_number":71,"context_line":"including the service name.  This will cause the administration guide to be"},{"line_number":72,"context_line":"published when updates are merged."},{"line_number":73,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_bb70f0a6","line":70,"range":{"start_line":69,"start_character":46,"end_line":70,"end_character":6},"in_reply_to":"dfeb2761_23328411","updated":"2017-04-04 10:40:14.000000000","message":"Sure :)","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b074da5676382341b7446b1cb99dc7a903669548","unresolved":false,"context_lines":[{"line_number":66,"context_line":"prioritizes projects for localization."},{"line_number":67,"context_line":""},{"line_number":68,"context_line":"To publish the project\u0027s administrator guide, the project will implement a tox"},{"line_number":69,"context_line":"target to build the guide, similar to the one created for the installation"},{"line_number":70,"context_line":"guides. A gate job template \u0027admin-guide-jobs\u0027 will be added to the project"},{"line_number":71,"context_line":"including the service name.  This will cause the administration guide to be"},{"line_number":72,"context_line":"published when updates are merged."},{"line_number":73,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_03930051","line":70,"range":{"start_line":69,"start_character":46,"end_line":70,"end_character":6},"in_reply_to":"ffe62b97_568b181e","updated":"2017-04-04 00:23:00.000000000","message":"I do have it below in the references, but I will make it an actual link on the next revision.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"9fef8a9498dc23d75f7b66edb5180787b782cc09","unresolved":false,"context_lines":[{"line_number":107,"context_line":"    * Images and instances"},{"line_number":108,"context_line":"    ..."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"One difference with the administrator guide from the installation guide is"},{"line_number":111,"context_line":"that all of the administrator guides are listed on one page. This makes it"},{"line_number":112,"context_line":"easier for users to find any of the official OpenStack project administrator"},{"line_number":113,"context_line":"guides."},{"line_number":114,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"ffe62b97_3693f451","line":111,"range":{"start_line":110,"start_character":0,"end_line":111,"end_character":60},"updated":"2017-03-27 09:52:14.000000000","message":"Will it not be the same for the Admin Guide? How will it be different?","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"bfe9c06eba74b2142575d250bf936d059a13f0a7","unresolved":false,"context_lines":[{"line_number":107,"context_line":"    * Images and instances"},{"line_number":108,"context_line":"    ..."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"One difference with the administrator guide from the installation guide is"},{"line_number":111,"context_line":"that all of the administrator guides are listed on one page. This makes it"},{"line_number":112,"context_line":"easier for users to find any of the official OpenStack project administrator"},{"line_number":113,"context_line":"guides."},{"line_number":114,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_c33e38d9","line":111,"range":{"start_line":110,"start_character":0,"end_line":111,"end_character":60},"in_reply_to":"dfeb2761_a3fa1472","updated":"2017-04-04 00:43:27.000000000","message":"Eventually, the Install Guide should become more seamless here too. This is sane.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b074da5676382341b7446b1cb99dc7a903669548","unresolved":false,"context_lines":[{"line_number":107,"context_line":"    * Images and instances"},{"line_number":108,"context_line":"    ..."},{"line_number":109,"context_line":""},{"line_number":110,"context_line":"One difference with the administrator guide from the installation guide is"},{"line_number":111,"context_line":"that all of the administrator guides are listed on one page. This makes it"},{"line_number":112,"context_line":"easier for users to find any of the official OpenStack project administrator"},{"line_number":113,"context_line":"guides."},{"line_number":114,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_a3fa1472","line":111,"range":{"start_line":110,"start_character":0,"end_line":111,"end_character":60},"in_reply_to":"ffe62b97_3693f451","updated":"2017-04-04 00:23:00.000000000","message":"The admin guide should continue to have a list with all of the projects and their guides.  Currently the installation guide page lists some of the projects and then hides the rest under \"Additional services\".  We do not want \"Additional services\" on the admin guide page.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"9fef8a9498dc23d75f7b66edb5180787b782cc09","unresolved":false,"context_lines":[{"line_number":112,"context_line":"easier for users to find any of the official OpenStack project administrator"},{"line_number":113,"context_line":"guides."},{"line_number":114,"context_line":""},{"line_number":115,"context_line":"With this change the administrator guide will now be versioned by release to"},{"line_number":116,"context_line":"allow version specific content.  This will be handled the same way the"},{"line_number":117,"context_line":"installation guide is versioned.  Administrator guides built from master will"},{"line_number":118,"context_line":"be published to \"draft\" while stable branches will publish to the respective"},{"line_number":119,"context_line":"release directory."},{"line_number":120,"context_line":""},{"line_number":121,"context_line":"::"},{"line_number":122,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"ffe62b97_36bc14ba","line":119,"range":{"start_line":115,"start_character":0,"end_line":119,"end_character":18},"updated":"2017-03-27 09:52:14.000000000","message":"this all just seems a bit contradictory to the above para. We can probs remove the above one.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"b8ad02dc6cd23994f8724378a00cf338cf28c8a0","unresolved":false,"context_lines":[{"line_number":112,"context_line":"easier for users to find any of the official OpenStack project administrator"},{"line_number":113,"context_line":"guides."},{"line_number":114,"context_line":""},{"line_number":115,"context_line":"With this change the administrator guide will now be versioned by release to"},{"line_number":116,"context_line":"allow version specific content.  This will be handled the same way the"},{"line_number":117,"context_line":"installation guide is versioned.  Administrator guides built from master will"},{"line_number":118,"context_line":"be published to \"draft\" while stable branches will publish to the respective"},{"line_number":119,"context_line":"release directory."},{"line_number":120,"context_line":""},{"line_number":121,"context_line":"::"},{"line_number":122,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_fb067886","line":119,"range":{"start_line":115,"start_character":0,"end_line":119,"end_character":18},"in_reply_to":"dfeb2761_83095032","updated":"2017-04-04 10:40:14.000000000","message":"Maybe I just read it wrong in a haze one day.... cause it makes sense now. I think I just misunderstood your first para there :)","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":9162,"name":"Lana Brindley","email":"openstack@lanabrindley.com","username":"loquacity"},"change_message_id":"bfe9c06eba74b2142575d250bf936d059a13f0a7","unresolved":false,"context_lines":[{"line_number":112,"context_line":"easier for users to find any of the official OpenStack project administrator"},{"line_number":113,"context_line":"guides."},{"line_number":114,"context_line":""},{"line_number":115,"context_line":"With this change the administrator guide will now be versioned by release to"},{"line_number":116,"context_line":"allow version specific content.  This will be handled the same way the"},{"line_number":117,"context_line":"installation guide is versioned.  Administrator guides built from master will"},{"line_number":118,"context_line":"be published to \"draft\" while stable branches will publish to the respective"},{"line_number":119,"context_line":"release directory."},{"line_number":120,"context_line":""},{"line_number":121,"context_line":"::"},{"line_number":122,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_83095032","line":119,"range":{"start_line":115,"start_character":0,"end_line":119,"end_character":18},"in_reply_to":"dfeb2761_833a7031","updated":"2017-04-04 00:43:27.000000000","message":"Yeah, I\u0027m with Michael. I don\u0027t see the contradiction?","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b074da5676382341b7446b1cb99dc7a903669548","unresolved":false,"context_lines":[{"line_number":112,"context_line":"easier for users to find any of the official OpenStack project administrator"},{"line_number":113,"context_line":"guides."},{"line_number":114,"context_line":""},{"line_number":115,"context_line":"With this change the administrator guide will now be versioned by release to"},{"line_number":116,"context_line":"allow version specific content.  This will be handled the same way the"},{"line_number":117,"context_line":"installation guide is versioned.  Administrator guides built from master will"},{"line_number":118,"context_line":"be published to \"draft\" while stable branches will publish to the respective"},{"line_number":119,"context_line":"release directory."},{"line_number":120,"context_line":""},{"line_number":121,"context_line":"::"},{"line_number":122,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_833a7031","line":119,"range":{"start_line":115,"start_character":0,"end_line":119,"end_character":18},"in_reply_to":"ffe62b97_36bc14ba","updated":"2017-04-04 00:23:00.000000000","message":"I am missing where we are contradictory above.\nThis is talking to the desire to have the admin guide versioned by release.  This does not talk to the layout of the index of guides.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"0f123b261636eab50bef88192cf6641f4b81659e","unresolved":false,"context_lines":[{"line_number":120,"context_line":""},{"line_number":121,"context_line":"::"},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"  The master branch of octavia would publish to:"},{"line_number":124,"context_line":"  http://docs.openstack.org/project-install-guide/draft/loadbalancer"},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"  The stable/pike branch of octavia would publish to:"},{"line_number":127,"context_line":"  http://docs.openstack.org/project-install-guide/pike/loadbalancer"},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"Alternatives"},{"line_number":130,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_2eeb6e13","line":127,"range":{"start_line":123,"start_character":0,"end_line":127,"end_character":67},"updated":"2017-04-04 16:24:58.000000000","message":"Let\u0027s use project-admin-guide here - or whatever location we want.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"38e6430f7a34742431d70ad9d07d4f1c3779cd29","unresolved":false,"context_lines":[{"line_number":120,"context_line":""},{"line_number":121,"context_line":"::"},{"line_number":122,"context_line":""},{"line_number":123,"context_line":"  The master branch of octavia would publish to:"},{"line_number":124,"context_line":"  http://docs.openstack.org/project-install-guide/draft/loadbalancer"},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"  The stable/pike branch of octavia would publish to:"},{"line_number":127,"context_line":"  http://docs.openstack.org/project-install-guide/pike/loadbalancer"},{"line_number":128,"context_line":""},{"line_number":129,"context_line":"Alternatives"},{"line_number":130,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_6ec3ad39","line":127,"range":{"start_line":123,"start_character":0,"end_line":127,"end_character":67},"in_reply_to":"dfeb2761_2eeb6e13","updated":"2017-04-04 21:58:41.000000000","message":"Done","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"41f044b29a9569acdecaf21ee8b195d2dbcc9f41","unresolved":false,"context_lines":[{"line_number":146,"context_line":"Entire documentation team"},{"line_number":147,"context_line":""},{"line_number":148,"context_line":""},{"line_number":149,"context_line":"Work Items"},{"line_number":150,"context_line":"----------"},{"line_number":151,"context_line":"* Setup cookiecutter for the administrator guide."},{"line_number":152,"context_line":"* Encourage the project teams to move existing content to project team"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ffe62b97_b3ccab6a","line":149,"range":{"start_line":149,"start_character":0,"end_line":149,"end_character":10},"updated":"2017-03-27 12:57:48.000000000","message":"I remember to have a wiki page to follow the progress of the Install Guide transition. De we plan to have that for the Admin Guide changes as well? Would that make sense to add that to the work items?","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"38e6430f7a34742431d70ad9d07d4f1c3779cd29","unresolved":false,"context_lines":[{"line_number":146,"context_line":"Entire documentation team"},{"line_number":147,"context_line":""},{"line_number":148,"context_line":""},{"line_number":149,"context_line":"Work Items"},{"line_number":150,"context_line":"----------"},{"line_number":151,"context_line":"* Setup cookiecutter for the administrator guide."},{"line_number":152,"context_line":"* Encourage the project teams to move existing content to project team"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_eee45de2","line":149,"range":{"start_line":149,"start_character":0,"end_line":149,"end_character":10},"in_reply_to":"ffe62b97_b3ccab6a","updated":"2017-04-04 21:58:41.000000000","message":"Done","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b074da5676382341b7446b1cb99dc7a903669548","unresolved":false,"context_lines":[{"line_number":146,"context_line":"Entire documentation team"},{"line_number":147,"context_line":""},{"line_number":148,"context_line":""},{"line_number":149,"context_line":"Work Items"},{"line_number":150,"context_line":"----------"},{"line_number":151,"context_line":"* Setup cookiecutter for the administrator guide."},{"line_number":152,"context_line":"* Encourage the project teams to move existing content to project team"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_2315e49c","line":149,"range":{"start_line":149,"start_character":0,"end_line":149,"end_character":10},"in_reply_to":"ffe62b97_b3ccab6a","updated":"2017-04-04 00:23:00.000000000","message":"Yes, I will add that in the next patch.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":9562,"name":"Ildiko Vancsa","email":"ildiko.vancsa@gmail.com","username":"ildikov"},"change_message_id":"41f044b29a9569acdecaf21ee8b195d2dbcc9f41","unresolved":false,"context_lines":[{"line_number":156,"context_line":"* Setup gate jobs to publish the administrator guide on patch merge."},{"line_number":157,"context_line":"* Update the Documentation Contributor Guide to include the required steps"},{"line_number":158,"context_line":"  to setup a project administrator guide."},{"line_number":159,"context_line":"* Notify project teams when this method of publishing the project specific"},{"line_number":160,"context_line":"  administrator guide is available."},{"line_number":161,"context_line":""},{"line_number":162,"context_line":"Dependencies"},{"line_number":163,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ffe62b97_53c55f5a","line":160,"range":{"start_line":159,"start_character":2,"end_line":160,"end_character":35},"updated":"2017-03-27 12:57:48.000000000","message":"Does this mean all the above steps to be completed?","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b074da5676382341b7446b1cb99dc7a903669548","unresolved":false,"context_lines":[{"line_number":156,"context_line":"* Setup gate jobs to publish the administrator guide on patch merge."},{"line_number":157,"context_line":"* Update the Documentation Contributor Guide to include the required steps"},{"line_number":158,"context_line":"  to setup a project administrator guide."},{"line_number":159,"context_line":"* Notify project teams when this method of publishing the project specific"},{"line_number":160,"context_line":"  administrator guide is available."},{"line_number":161,"context_line":""},{"line_number":162,"context_line":"Dependencies"},{"line_number":163,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_e30edc8b","line":160,"range":{"start_line":159,"start_character":2,"end_line":160,"end_character":35},"in_reply_to":"ffe62b97_53c55f5a","updated":"2017-04-04 00:23:00.000000000","message":"I think so.  I was trying to address Andreas comment about notifying the project teams.","commit_id":"42bdb8fbb7742c35581e5a66e0940e9b51defb11"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"06cffa6820e1dd1fde787d7f050cb4f10fac38e0","unresolved":false,"context_lines":[{"line_number":10,"context_line":""},{"line_number":11,"context_line":"The number of approved OpenStack projects continues to grow while the"},{"line_number":12,"context_line":"documentation team resources are shrinking. We need a new approach to maintain"},{"line_number":13,"context_line":"the high quality of the OpenStack documentation set."},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"This specification proposes allowing project teams to manage their"},{"line_number":16,"context_line":"administrator guide content similar to how the api-ref and installation guides"}],"source_content_type":"text/x-rst","patch_set":9,"id":"bff0334d_545f850d","line":13,"updated":"2017-04-07 15:40:39.000000000","message":"I\u0027m not sure about this problem statement...\n\nWe already use this \"new\" approach for several deliverables. Also, I don\u0027t think we have data saying that doc team resources are shrinking, even when there is a perception of scarcity. \n\nWith my concerns about perception in mind (scarcity and newness), how about this instead:\n\n\"The growth of the number of OpenStack projects that are administered by an operator base continues to grow. With growth and resource sharing in mind, we want to ensure that the quality of an OpenStack administrator guide remains high. To meet this goal, we think it\u0027s best to distribute the maintenance of the source doc files within the project team\u0027s repositories.\"","commit_id":"1172a88a440581c1e4d0e663aa574c047a5a1e5d"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"06cffa6820e1dd1fde787d7f050cb4f10fac38e0","unresolved":false,"context_lines":[{"line_number":22,"context_line":"Currently there are over sixty approved OpenStack projects. It is unreasonable"},{"line_number":23,"context_line":"to expect the documentation team to maintain the administrator guide for all"},{"line_number":24,"context_line":"of these projects. We need to optimize our usage of the documentation team\u0027s"},{"line_number":25,"context_line":"limited resources."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"Currently the administrator guide is in a seperate git repository from the"},{"line_number":28,"context_line":"code and patches being proposed.  This leads to an \"out of site, out of mind\""}],"source_content_type":"text/x-rst","patch_set":9,"id":"bff0334d_b49811c0","line":25,"updated":"2017-04-07 15:40:39.000000000","message":"Again, I\u0027d like to think we have an abundance mindset and there\u0027s enough perception problem already, let\u0027s not further this \"limited\" perception in this spec. Revise as \"We need to optimize the usage of the documentation teams resources.\" please.","commit_id":"1172a88a440581c1e4d0e663aa574c047a5a1e5d"}]}