Anne and Colin, <span></span>I'd be happy to help with content management and migration. -Nermina <br><br>On Monday, October 21, 2013, Anne Gentle wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Oct 10, 2013 at 12:02 PM, Colin McNamara <span dir="ltr"><<a href="javascript:_e({}, 'cvml', 'colin@2cups.com');" target="_blank">colin@2cups.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div style="word-wrap:break-word">I absolutely believe that the appropriate role is to improve the source documentation. Right now I'm just riding a find line between improving and duplicating. My focus has been on getting the structure of training-guides through included content, and then when we get to our alpha to focus on improving the referenced content. <div>
<br></div><div>A direct example of that would on the administrative section that references the user-guide content. There are items in there that could benefit from visual representation of the steps noted. My goal is to get the included content roughed out in the training-guide, and then engage the user group contributors that we have been building to do things like create visual representations of configuration steps that are unclear. </div>
<div><br></div><div>So, to be very clear. My goals are to improve the source documentation. My suggested method is to focus on xi:inclusion as much as possible within training-guides. This drives the improvement in content to the sources that are referenced, vs creating yet another external operations guide that won't be able to map to the six month release schedule.</div>
</div></blockquote><div><br></div><div><br></div><div>Circling back to take a closer look now that the release is out. </div><div><br></div><div>I like your main goal of improving the source documentation. But RST documentation isn't great source since it can't be xi:included, it gets hung up in reviews for a long time, it's not well maintained, I'm just not sure you want to use it as your source. I'm trying to help you avoid a pitfall here. :) </div>
<div><br></div><div>So far the data shows that the dev docs are less maintained, when we bring them in to openstack-manuals they tend to improve at a faster rate. I could go through your review a file at a time and tell you where the info should go, but I can't make it a priority myself right now. Is there anyone else you can identify to help you with content placement? I'd also recommend a file at a time to help reviewers review your patches. Or a project at a time. Some way of helping reviewers see the whole deliverable will help reviewers.</div>
<div><br></div><div>Anyone else want to add to the discussion? Feel free to add RST-as-source to tomorrow's doc team meeting agenda at <a href="https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting" target="_blank">https://wiki.openstack.org/wiki/Meetings/DocTeamMeeting#Agenda_for_next_meeting</a>. </div>
<div><br></div><div>Anne</div><div><br></div><div> </div><blockquote style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div style="word-wrap:break-word">
<div><div><div><div>
<div style="text-indent:0px;letter-spacing:normal;font-variant:normal;text-align:-webkit-auto;font-style:normal;font-weight:normal;line-height:normal;text-transform:none;font-size:medium;white-space:normal;font-family:Helvetica;word-wrap:break-word;word-spacing:0px">
<div style="font-style:normal;font-variant:normal;font-weight:normal;letter-spacing:normal;line-height:normal;text-align:-webkit-auto;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;word-wrap:break-word">
<div style="font-style:normal;font-variant:normal;font-weight:normal;letter-spacing:normal;line-height:normal;text-align:-webkit-auto;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;word-wrap:break-word">
<div style="font-style:normal;font-variant:normal;letter-spacing:normal;line-height:normal;text-align:-webkit-auto;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;word-wrap:break-word"><div style="font-style:normal;font-variant:normal;letter-spacing:normal;line-height:normal;text-align:-webkit-auto;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;word-wrap:break-word">
<p style="font-size:medium;font-family:Helvetica;font-weight:normal">Regards,</p><p style="font-size:medium;font-family:Helvetica;font-weight:normal">Colin</p><div style="font-size:medium;font-family:Helvetica;font-weight:normal">
<b style="font-family:Calibri,sans-serif;font-size:15px"><span style="font-size:12pt;color:navy;font-family:Arial,sans-serif">Colin McNamara</span></b><br></div><div style="font-size:medium;font-family:Helvetica"><span style="font-family:Calibri,sans-serif;font-size:15px"><span style="font-size:12pt;color:navy;font-family:Arial,sans-serif">People | Process | Technology</span></span></div>
<div><font color="#000080" face="Arial, sans-serif"><span style="font-size:16px">--------------------------------------------</span></font></div><div style="font-size:medium;font-family:Helvetica;font-weight:normal"><div style="font-family:Calibri,sans-serif;font-size:11pt;margin:0in 0in 0.0001pt">
<b><span style="font-size:10pt;color:rgb(31,73,125);font-family:Arial,sans-serif">Mobile</span></b><span style="font-size:10pt;color:rgb(31,73,125);font-family:Arial,sans-serif">: <span style="white-space:pre-wrap"> </span><a value="+18582088105">858-208-8105</a></span></div>
<div style="margin:0in 0in 0.0001pt"><font color="#1f497d" face="Arial, sans-serif"><span style="font-size:13px"><b>Twitter:<span style="white-space:pre-wrap"> </span></b></span></font><a href="http://www.twitter.com/colinmcnamara" target="_blank">@colinmcnamara</a></div>
<div style="font-family:Calibri,sans-serif;font-size:11pt;margin:0in 0in 0.0001pt"><span style="color:rgb(31,73,125);font-family:Arial,sans-serif;font-size:13px"><b>Linkedin</b>:<span style="white-space:pre-wrap"> </span></span><a href="http://www.linkedin.com/colinmcnamara" style="font-family:Arial,sans-serif;font-size:13px" target="_blank">www.</a><a href="http://www.linkedin.com/colinmcnamara" style="font-family:Arial,sans-serif;font-size:13px" target="_blank">linkedin.com/colinmcnamara</a></div>
<div style="font-family:Calibri,sans-serif;font-size:11pt;margin:0in 0in 0.0001pt"><b style="color:rgb(31,73,125);font-family:Arial,sans-serif;font-size:13px">Blog</b><span style="color:rgb(31,73,125);font-family:Arial,sans-serif;font-size:13px">:<span style="white-space:pre-wrap"> </span></span><a href="http://www.colinmcnamara.com/" style="font-family:Arial,sans-serif;font-size:13px" target="_blank">www.colinmcnamara.com</a></div>
<div style="font-family:Calibri,sans-serif;font-size:11pt;margin:0in 0in 0.0001pt"><b style="color:rgb(31,73,125);font-family:Arial,sans-serif;font-size:13px">Email</b><span style="color:rgb(31,73,125);font-family:Arial,sans-serif;font-size:13px">:</span><span style="color:rgb(31,73,125);font-family:Arial,sans-serif;font-size:13px;white-space:pre-wrap"> </span><a>colin@2cups.com</a><span style="color:rgb(31,73,125);font-family:Arial,sans-serif;font-size:13px;white-space:pre-wrap"> </span></div>
<div style="font-family:Calibri,sans-serif;font-size:11pt;margin:0in 0in 0.0001pt"><br></div></div></div></div></div><br></div><br></div><br><br>
</div>
<br></div><div><div><div><div>On Oct 10, 2013, at 9:35 AM, Anne Gentle <<a>annegentle@justwriteclick.com</a>> wrote:</div><br><blockquote type="cite">
<div dir="ltr"><br><div><br><br><div>On Thu, Oct 10, 2013 at 11:06 AM, Colin McNamara <span dir="ltr"><<a></a></span></div></div></div></blockquote></div></div></div></div></div></div></blockquote></div><br><br clear="all">
<div><br></div>-- <br>Anne Gentle<br><a href="javascript:_e({}, 'cvml', 'annegentle@justwriteclick.com');" target="_blank">annegentle@justwriteclick.com</a>
</div></div>
</blockquote><br><br>-- <br><div dir="ltr">Thank you!<div><br></div><div>Nermina Miller</div><div>Tech Writer and Editor</div></div><br>