<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">Hi Alex,<div class=""><br class=""></div><div class="">Please see my comments in line.</div><div class=""><br class=""></div><div class="">Thanks,</div><div class="">Ildikó</div><div class=""><br class=""></div><div class=""><br class=""><div><blockquote type="cite" class=""><div class="">On 2017. Feb 7., at 5:35, Alexandra Settle <<a href="mailto:a.settle@outlook.com" class="">a.settle@outlook.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div class="WordSection1" style="page: WordSection1; font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255);"><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class="">Hey Ildiko and Joseph,<o:p class=""></o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class="">I like the enthusiasm<span class="Apple-converted-space"> </span></span><span style="font-size: 11pt; font-family: Wingdings;" class="">J</span><span style="font-size: 11pt; font-family: Calibri;" class=""><span class="Apple-converted-space"> </span>thank you both for getting on board!<o:p class=""></o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class="">To answer your questions Ildiko, they are usually in-tree:<a href="https://github.com/openstack/swift/tree/master/install-guide/source" style="color: purple; text-decoration: underline;" class="">https://github.com/openstack/swift/tree/master/install-guide/source</a><span class="Apple-converted-space"> </span>(just an example)</span></div></div></div></blockquote><div><br class=""></div><div>Great, that’s what I remembered too.</div><br class=""><blockquote type="cite" class=""><div class=""><div class="WordSection1" style="page: WordSection1; font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255);"><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class="">Not to shoot everyone down in flames straight away but we need to have a deep dive discussion about this at the PTG before we create repos and build environments.<o:p class=""></o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class="">Our Install Guides and Deployment Guide methods are based off what you are suggesting. I would recommend reading the project-specific install guide plan here:<font color="#800080" class=""><u class=""><a href="http://specs.openstack.org/openstack/docs-specs/specs/newton/project-specific-installguides.html" class="">http://specs.openstack.org/openstack/docs-specs/specs/newton/project-specific-installguides.html</a></u></font></span></div></div></div></blockquote><div><br class=""></div><div>I added this reference to the PTG etherpad too, so we have relevant links at one place. It can also serve as a reminder. :)</div><br class=""><blockquote type="cite" class=""><div class=""><div class="WordSection1" style="page: WordSection1; font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255);"><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""><o:p class=""></o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class="">That being said, it is up to the project to include the relevant administration guide section, and not up to us. We would have to ensure several of the following things:<o:p class=""></o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman'; text-indent: -0.25in;" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""><span class="">1.<span style="font-style: normal; font-variant-caps: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-family: 'Times New Roman';" class=""> <span class="Apple-converted-space"> </span></span></span></span><span style="font-size: 11pt; font-family: Calibri;" class="">Project teams are on board and are capable themselves to look after their administration content(s).<o:p class=""></o:p></span></div><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman'; text-indent: -0.25in;" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""><span class="">2.<span style="font-style: normal; font-variant-caps: normal; font-weight: normal; font-size: 7pt; line-height: normal; font-family: 'Times New Roman';" class=""> <span class="Apple-converted-space"> </span></span></span></span><span style="font-size: 11pt; font-family: Calibri;" class="">We have the bandwidth to plan and action this item – which, at the moment, I have every intention of directing our team to on our already large pile of technical debt. I would prefer not to add any more without dedicated free resources.<o:p class=""></o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class="">I would like to take these ideas and bring them to table at the PTG and ensure, first of all, we have full team support. After that, we need to ensure we have a fully approved specification similar to the one above.</span></div></div></div></blockquote><div><br class=""></div><div>+1</div><br class=""><blockquote type="cite" class=""><div class="WordSection1" style="page: WordSection1; font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255);"><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""><o:p class=""></o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class="">Please do not take this as a deterrence from any major discussion points, I think this is definitely a conversation we should be having.<span class="Apple-converted-space"> </span></span><span style="font-size: 11pt; font-family: Wingdings;" class="">J</span><span style="font-size: 11pt; font-family: Calibri;" class=""><span class="Apple-converted-space"> </span>But we already have a large list of items to tackle for the Pike release and it is my job to ensure they are actioned and that we are not overloading our shrinking team.</span></div></div></blockquote><div><br class=""></div><div>I hope this activity will overall help the team. I understand that the road towards the end goal will generate extra load, although I also hope that with having a plan in place we might have a few more hands to help out. Also I would guess we can rely a bit on docs liaisons as well if we’re successful with identifying smaller tasks and a reasonable timeline.</div><br class=""><blockquote type="cite" class=""><div class="WordSection1" style="page: WordSection1; font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255);"><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class="">Hopefully this answers some of your questions, and positions us for some good conversations and planning points at the PTG<span class="Apple-converted-space"> </span></span><span style="font-size: 11pt; font-family: Wingdings;" class="">J</span></div></div></blockquote><div><br class=""></div><div>Thank you for the support. I’m looking forward to meet with you all at the PTG. :)</div><br class=""><blockquote type="cite" class=""><div class="WordSection1" style="page: WordSection1; font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255);"><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class="">Cheers,<o:p class=""></o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class="">Alex<o:p class=""></o:p></span></div><div style="margin: 0in 0in 0.0001pt; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div><div style="border-style: solid none none; border-top-color: rgb(181, 196, 223); border-top-width: 1pt; padding: 3pt 0in 0in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><b class=""><span style="font-family: Calibri;" class="">From:<span class="Apple-converted-space"> </span></span></b><span style="font-family: Calibri;" class="">Ildiko Vancsa <<a href="mailto:ildiko.vancsa@gmail.com" class="">ildiko.vancsa@gmail.com</a>><br class=""><b class="">Date:<span class="Apple-converted-space"> </span></b>Monday, February 6, 2017 at 6:30 PM<br class=""><b class="">To:<span class="Apple-converted-space"> </span></b>Joseph Robinson <<a href="mailto:joseph.robinson@RACKSPACE.COM" class="">joseph.robinson@RACKSPACE.COM</a>><br class=""><b class="">Cc:<span class="Apple-converted-space"> </span></b>Alexandra Settle <<a href="mailto:a.settle@outlook.com" class="">a.settle@outlook.com</a>>, Lana Brindley <<a href="mailto:openstack@lanabrindley.com" class="">openstack@lanabrindley.com</a>>, "<a href="mailto:openstack-docs@lists.openstack.org" class="">openstack-docs@lists.openstack.org</a>" <<a href="mailto:openstack-docs@lists.openstack.org" class="">openstack-docs@lists.openstack.org</a>><br class=""><b class="">Subject:<span class="Apple-converted-space"> </span></b>Re: [OpenStack-docs] Admin Guide enhancements<o:p class=""></o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><o:p class=""> </o:p></div></div><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">Hi Joseph,<span class="Apple-converted-space"> </span><o:p class=""></o:p></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><o:p class=""> </o:p></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">Thanks for the feedback and ideas. I added further comments in line below.<o:p class=""></o:p></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><o:p class=""> </o:p></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">Thanks,<o:p class=""></o:p></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">Ildikó<o:p class=""></o:p></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><o:p class=""> </o:p></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><o:p class=""> </o:p></div></div><div class=""><div class=""><blockquote style="margin-top: 5pt; margin-bottom: 5pt;" class=""><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">On 2017. Feb 2., at 21:51, Joseph Robinson <<a href="mailto:joseph.robinson@RACKSPACE.COM" style="color: purple; text-decoration: underline;" class="">joseph.robinson@RACKSPACE.COM</a>> wrote:<o:p class=""></o:p></div></div><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><o:p class=""> </o:p></div><div class=""><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class="">Hi all,<o:p class=""></o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class="">Ildiko, this sounds like a good plan – especially if moving the admin guide content into the developer repository is easier for the project teams to work with. <o:p class=""></o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class="">It seems like the next step since the user and admin guides were separated.<o:p class=""></o:p></span></div></div></div></blockquote><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><o:p class=""> </o:p></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">+1<o:p class=""></o:p></div></div><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><br class=""><br class=""><o:p class=""></o:p></div><blockquote style="margin-top: 5pt; margin-bottom: 5pt;" class=""><div class=""><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class="">This is pre-empting the PTG discussion somewhat, however I’m ready to help create repositories and build environments with the project teams to migrate the admin guide content, if we decide to use a similar process to the install guides and deploy guide. <o:p class=""></o:p></span></div></div></div></blockquote><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><o:p class=""> </o:p></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">Do we have projects where they store the docs in separate repo from the code or it’s usually in-tree?<o:p class=""></o:p></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><o:p class=""> </o:p></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">I’m happy to start discussions/activities even before the PTG if we can, I think that should help with having a good progress with this in Pike.<o:p class=""></o:p></div></div><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><br class=""><br class=""><o:p class=""></o:p></div><blockquote style="margin-top: 5pt; margin-bottom: 5pt;" class=""><div class=""><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class="">Also, with the original bug: <a href="https://bugs.launchpad.net/openstack-manuals/+bug/1458820" style="color: purple; text-decoration: underline;" class=""><span style="font-size: 9pt; font-family: Helvetica; color: purple;" class="">https://bugs.launchpad.net/openstack-manuals/+bug/1458820</span></a> after the PTG meetings, I could mark this as closed, and we can move to a specification, and then blueprint to migrate admin guide content? <o:p class=""></o:p></span></div></div></div></blockquote><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><o:p class=""> </o:p></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">I think it is a great plan. It’s better to track the activities in a blueprint once we agreed on the direction and the next steps.<o:p class=""></o:p></div></div><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><br class=""><br class=""><o:p class=""></o:p></div><blockquote style="margin-top: 5pt; margin-bottom: 5pt;" class=""><div class=""><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class="">Those are my thoughts for now. Thanks for bringing the idea forward :).<o:p class=""></o:p></span></div></div></div></blockquote><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><o:p class=""> </o:p></div></div><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">Thank you for your support. :)<o:p class=""></o:p></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><br class=""><br class=""><o:p class=""></o:p></div><blockquote style="margin-top: 5pt; margin-bottom: 5pt;" class=""><div class=""><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div></div><div class=""><div class=""><div class=""><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class="">Best Regards,<o:p class=""></o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class=""> <o:p class=""></o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class="">Joe Robinson<o:p class=""></o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class="">Information Developer II<o:p class=""></o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class=""> -------------------------------<o:p class=""></o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class=""><a href="mailto:Joseph.Robinson@Rackspace.com" style="color: purple; text-decoration: underline;" class=""><span style="color: purple;" class="">Joseph.Robinson@Rackspace.com</span></a><o:p class=""></o:p></span></div></div></div></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div></div><div style="border-style: solid none none; border-top-color: rgb(181, 196, 223); border-top-width: 1pt; padding: 3pt 0in 0in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><b class=""><span style="font-size: 11pt; font-family: Calibri;" class="">From:<span class="apple-converted-space"> </span></span></b><span style="font-size: 11pt; font-family: Calibri;" class="">Alexandra Settle <<a href="mailto:a.settle@outlook.com" style="color: purple; text-decoration: underline;" class=""><span style="color: purple;" class="">a.settle@outlook.com</span></a>><br class=""><b class="">Date:<span class="apple-converted-space"> </span></b>Thursday, 2 February 2017 at 1:06 AM<br class=""><b class="">To:<span class="apple-converted-space"> </span></b>Ildiko Vancsa <<a href="mailto:ildiko.vancsa@gmail.com" style="color: purple; text-decoration: underline;" class=""><span style="color: purple;" class="">ildiko.vancsa@gmail.com</span></a>>, Lana Brindley <<a href="mailto:openstack@lanabrindley.com" style="color: purple; text-decoration: underline;" class=""><span style="color: purple;" class="">openstack@lanabrindley.com</span></a>><br class=""><b class="">Cc:<span class="apple-converted-space"> </span></b>"<a href="mailto:openstack-docs@lists.openstack.org" style="color: purple; text-decoration: underline;" class=""><span style="color: purple;" class="">openstack-docs@lists.openstack.org</span></a>" <<a href="mailto:openstack-docs@lists.openstack.org" style="color: purple; text-decoration: underline;" class=""><span style="color: purple;" class="">openstack-docs@lists.openstack.org</span></a>><br class=""><b class="">Subject:<span class="apple-converted-space"> </span></b>Re: [OpenStack-docs] Admin Guide enhancements<o:p class=""></o:p></span></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class=""><o:p class=""> </o:p></span></div></div><div class=""><div class=""><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class="">Thanks Ildiko<span class="apple-converted-space"> </span></span><span style="font-size: 11pt; font-family: Wingdings;" class="">J</span><span class="apple-converted-space"><span style="font-size: 11pt; font-family: Calibri;" class=""> </span></span><span style="font-size: 11pt; font-family: Calibri;" class="">looking forward to discussing this with you at the PTG!</span><o:p class=""></o:p></div></div><div class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 11pt; font-family: Calibri;" class=""> </span><o:p class=""></o:p></div></div><div style="border-style: solid none none; border-top-color: rgb(181, 196, 223); border-top-width: 1pt; padding: 3pt 0in 0in;" class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><b class=""><span style="font-family: Calibri;" class="">From:<span class="apple-converted-space"> </span></span></b><span style="font-family: Calibri;" class="">Ildiko Vancsa <<a href="mailto:ildiko.vancsa@gmail.com" style="color: purple; text-decoration: underline;" class=""><span style="color: purple;" class="">ildiko.vancsa@gmail.com</span></a>><br class=""><b class="">Date:<span class="apple-converted-space"> </span></b>Tuesday, January 31, 2017 at 5:43 PM<br class=""><b class="">To:<span class="apple-converted-space"> </span></b>Lana Brindley <<a href="mailto:openstack@lanabrindley.com" style="color: purple; text-decoration: underline;" class=""><span style="color: purple;" class="">openstack@lanabrindley.com</span></a>><br class=""><b class="">Cc:<span class="apple-converted-space"> </span></b>"<a href="mailto:openstack-docs@lists.openstack.org" style="color: purple; text-decoration: underline;" class=""><span style="color: purple;" class="">openstack-docs@lists.openstack.org</span></a>" <<a href="mailto:openstack-docs@lists.openstack.org" style="color: purple; text-decoration: underline;" class=""><span style="color: purple;" class="">openstack-docs@lists.openstack.org</span></a>><br class=""><b class="">Subject:<span class="apple-converted-space"> </span></b>Re: [OpenStack-docs] Admin Guide enhancements</span><o:p class=""></o:p></div></div></div><div class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""> <o:p class=""></o:p></div></div></div><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">Hi Lana,<span class="apple-converted-space"> </span><o:p class=""></o:p></div></div><div class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""> <o:p class=""></o:p></div></div></div><div class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">Thank you, it all sounds great!<o:p class=""></o:p></div></div></div><div class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""> <o:p class=""></o:p></div></div></div><div class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">I added the topic to the PTG etherpad and linked in the mail thread fro the archive.<o:p class=""></o:p></div></div></div><div class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""> <o:p class=""></o:p></div></div></div><div class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">Thanks,<o:p class=""></o:p></div></div></div><div class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">Ildikó<o:p class=""></o:p></div></div></div><div class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""> <o:p class=""></o:p></div></div></div><div class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""> <o:p class=""></o:p></div></div><div class=""><blockquote style="margin-top: 5pt; margin-bottom: 5pt;" class=""><div class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class="">On 2017. Jan 29., at 16:23, Lana Brindley <<a href="mailto:openstack@lanabrindley.com" style="color: purple; text-decoration: underline;" class=""><span style="color: purple;" class="">openstack@lanabrindley.com</span></a>> wrote:<o:p class=""></o:p></div></div></div><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""> <o:p class=""></o:p></div></div><div class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 9pt; font-family: Helvetica;" class="">Hi Ildikó,<br class=""><br class="">Comments inline ...<br class=""><br class="">On 27/01/17 20:12, Ildiko Vancsa wrote:<br class=""><br class=""><br class=""></span><o:p class=""></o:p></div></div><blockquote style="margin-top: 5pt; margin-bottom: 5pt;" class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 9pt; font-family: Helvetica;" class="">Hi Docs Team,<br class=""><br class="">TL;DR I have an old bug report for the Admin Guide which targeted the way how it is versioned, or maybe rather not versioned and which also implied other actions on that document, for which we weren’t ready at the time of reporting the issue.<br class=""><br class="">The bug report is the following:<span class="apple-converted-space"> </span><a href="https://bugs.launchpad.net/openstack-manuals/+bug/1458820" style="color: purple; text-decoration: underline;" class=""><span style="color: purple;" class="">https://bugs.launchpad.net/openstack-manuals/+bug/1458820</span></a><br class=""><br class="">The bug report itself highlights that it is hard both from usage and from maintenance perspective to handle a document which contains information about at least three OpenStack releases in an iterative way. When someone tries to figure out what belongs to one single OpenStack release in it they need to put it together from an original state and the changes since that. In case of Telemetry we had issues with listing the collected meters in a user friendly way for instance.<br class=""><br class="">Another big issue with the Admin Guide is the maintenance, which is tough with having the source files in a separate, centralized repository far away from the code where the changes happen. This way core reviewers have a hard time to keep the document in sync with the code as they cannot effectively -1 a code change as it *cannot* contain the doc changes.</span><o:p class=""></o:p></div></div></blockquote><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 9pt; font-family: Helvetica;" class=""><br class="">I agree, it gets messy.<br class=""><br class=""><br class=""><br class=""></span><o:p class=""></o:p></div></div><blockquote style="margin-top: 5pt; margin-bottom: 5pt;" class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 9pt; font-family: Helvetica;" class=""><br class="">The reason I bring this up now again as I see the experiment with moving the Install Guide chapters to the project repositories a successful initiative, I remember seeing positive feedbacks about that move on the ML, etc. I think someone brought even up the Admin Guide as next candidate to a similar move.</span><o:p class=""></o:p></div></div></blockquote><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 9pt; font-family: Helvetica;" class=""><br class="">We implemented the Deployment Guides in Ocata, and if we go by requests alone, then the Admin Guide is the next on the list.<br class=""><br class=""><br class=""><br class=""></span><o:p class=""></o:p></div></div><blockquote style="margin-top: 5pt; margin-bottom: 5pt;" class=""><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 9pt; font-family: Helvetica;" class=""><br class="">I would like to ask the Docs Team for their opinions about this topic. I see a lot of advantage in having the documentation living together with the code and also having version controlled together with the code. This would also remove some of the burden from the Docs team as well, which I see a beneficial change too.<br class=""><br class="">What is your view about this? Could this be a good topic for the upcoming PTG too maybe?</span><o:p class=""></o:p></div></div></blockquote><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 9pt; font-family: Helvetica;" class=""><br class="">I think it's sensible to consider, at the very least. Can you add it to the PTG etherpad for discussion?<br class=""><br class="">Lana<br class=""><br class="">--<span class="apple-converted-space"> </span><br class="">Lana Brindley<br class="">Technical Writer<br class="">Rackspace Cloud Builders Australia<br class=""></span><a href="http://lanabrindley.com/" style="color: purple; text-decoration: underline;" class=""><span style="font-size: 9pt; font-family: Helvetica; color: purple;" class="">http://lanabrindley.com</span></a><span style="font-size: 9pt; font-family: Helvetica;" class=""><br class=""><br class="">_______________________________________________<br class="">OpenStack-docs mailing list<br class=""></span><a href="mailto:OpenStack-docs@lists.openstack.org" style="color: purple; text-decoration: underline;" class=""><span style="font-size: 9pt; font-family: Helvetica; color: purple;" class="">OpenStack-docs@lists.openstack.org</span></a><span style="font-size: 9pt; font-family: Helvetica;" class=""><br class=""></span><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" style="color: purple; text-decoration: underline;" class=""><span style="font-size: 9pt; font-family: Helvetica; color: purple;" class="">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</span></a><o:p class=""></o:p></div></div></div></blockquote></div><div style="margin-left: 0.5in;" class=""><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""> <o:p class=""></o:p></div></div></div></div></div><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class=""> </span><o:p class=""></o:p></div><div class="MsoNormal" align="center" style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman'; text-align: center;"><hr size="2" width="100%" align="center" class=""></div><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><span style="font-size: 10.5pt; font-family: Calibri;" class="">Rackspace Hosting Australia PTY LTD a company registered in the state of Victoria, Australia (company registered number ACN 153 275 524) whose registered office is at Level 1, 37 Pitt Street, Sydney, NSW 2000, Australia. Rackspace Hosting Australia PTY LTD privacy policy can be viewed at<span class="apple-converted-space"> </span></span><a href="http://www.rackspace.com.au/company/legal-privacy-statement.php" style="color: purple; text-decoration: underline;" class=""><span style="font-size: 10.5pt; font-family: Calibri; color: purple;" class="">www.rackspace.com.au/company/legal-privacy-statement.php</span></a><span class="apple-converted-space"><span style="font-size: 10.5pt; font-family: Calibri;" class=""> </span></span><span style="font-size: 10.5pt; font-family: Calibri;" class="">- This e-mail message may contain confidential or privileged information intended for the recipient. Any dissemination, distribution or copying of the enclosed material is prohibited. If you receive this transmission in error, please notify us immediately by e-mail at<span class="apple-converted-space"> </span></span><a href="mailto:abuse@rackspace.com" style="color: purple; text-decoration: underline;" class=""><span style="font-size: 10.5pt; font-family: Calibri; color: purple;" class="">abuse@rackspace.com</span></a><span class="apple-converted-space"><span style="font-size: 10.5pt; font-family: Calibri;" class=""> </span></span><span style="font-size: 10.5pt; font-family: Calibri;" class="">and delete the original message. Your cooperation is appreciated.</span><o:p class=""></o:p></div></div></blockquote></div><div style="margin: 0in 0in 0.0001pt 0.5in; font-size: 12pt; font-family: 'Times New Roman';" class=""><o:p class=""> </o:p></div></div></div></blockquote></div><br class=""></div></body></html>