<div dir="ltr">Both situations. For the installation guide, we really don't want people finding and/or installing defunct releases because most new users don't understand the release cycle nor do we fix bugs in documentation for those releases. Filename changes impact all guides, regardless of version. If we rename a file, the old file becomes frozen in time, yet Google still finds it... often before the new file.</div><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Jun 17, 2016 at 9:24 AM, Anne Gentle <span dir="ltr"><<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>></span> 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><div class="gmail_quote"><span class="">On Fri, Jun 17, 2016 at 10:19 AM, Matt Kassawara <span dir="ltr"><<a href="mailto:mkassawara@gmail.com" target="_blank">mkassawara@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Anne,<div><br></div><div>I think we do a fairly good job of removing links to defunct documentation from d.o.o. However, we don't necessarily know what Google shows to people when they search for documentation, hence why we should probably make an effort to perform a general audit and remove files involving defunct documentation, particularly the installation guides.</div></div></blockquote><div><br></div></span><div>By defunct, do you mean:</div><div>Is no longer accurate for the current release? For example, the liberty install guide files are still accurate for installing liberty, so those files should remain.</div><div> </div><div>or</div><div><br></div><div>Is not intended to be read by anyone for any reason? For example, when a file name changes and the file remains indexed by Google but is not part of the intended deliverable.</div><div><br></div><div>An audit would be fine, as long as we know the parameters for the audit's accuracy.</div><div>Anne</div><div><div class="h5"><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Jun 17, 2016 at 7:18 AM, Anne Gentle <span dir="ltr"><<a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>></span> 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><div class="gmail_quote"><span>On Fri, Jun 17, 2016 at 4:16 AM, Pranav Salunke <span dir="ltr"><<a href="mailto:dguitarbite@gmail.com" target="_blank">dguitarbite@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div dir="ltr">Hello,<br><div class="gmail_extra"><div class="gmail_quote"><br></div><div class="gmail_quote">Thanks for acknowledging and identifying this issue. Check my in-line comments.</div><div class="gmail_quote"><span><br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div dir="ltr">One of our larger problems is that people just use Google, and Google loves to rank our old (often unlinked on d.o.o) content higher than new content because we can't effectively delete files. Without knowledge of release naming/cycle and the latest version, people often stumble upon older documentation that is either irrelevant or of questionable quality. For example, compare the installation guide for Juno with the installation guide for Mitaka.</div></blockquote><div><br></div></span><div>This is one of the bigger issues, apart from having confusion (from google's search results!) to linking to outdated documentation. </div></div></div></div></blockquote><div><br></div></span><div>When you see this it should be reported as a bug. Until we have improved docs publishing with <a href="http://specs.openstack.org/openstack-infra/infra-specs/specs/doc-publishing.html" target="_blank">http://specs.openstack.org/openstack-infra/infra-specs/specs/doc-publishing.html</a> the fix is a manual one, so a bug must be reported in order to fix the links to outdated documentation.</div><span><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div>Other aspect is that people want and like to use the official upstream documentation but there are other webpages which sneak in and kind of just mess around with the awesome updated documentation that we provide. </div></div></div></div></blockquote><div><br></div></span><div>Can you say more about this? The words "sneak" and "mess" sound like there's a deeper issue that we'll need more specifics if we want to fix it.<br></div><span><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div>I agree with Matt and add this other aspect which is confusing. Deliberately not naming the other non-upstream sources of documentation.</div></div></div></div></blockquote><div><br></div></span><div>Are you not naming the sources, or are you saying we don't name the sources and it would be useful to do so?</div><div><br></div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><span><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><span><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div><div><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex">
Thanks for sending this, I really appreciate all the kind words you have for the project!<br></blockquote></div></div></div></div></blockquote><div><br></div></span><div>Lana,</div><div> </div><div>Welcome :). I am a part of this team, so I fell entitled to bring up things to improve our teams efforts. </div><span><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div><div><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex">
As far as 'extra' efforts, I do try to get involved as much as possible, but there's always more that can be done (and by people who are not me!). I'm considering putting in a documentation talk for Barcelona, which I haven't done since becoming PTL, and I'm also spending a lot of time talking to our CPLs to ensure we have project visibility. The What's Up, Doc newsletter is also my way of getting our message out to other groups.<br></blockquote></div></div></div></div></blockquote><div><br></div></span><div>Lana, I agree, we should have a few talks showcasing the documentation team's efforts. Some internal team and process discussions, explaining the development models and also giving a high level overview of the <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a>. Most often people are confused about the scope of different books esp. I have heard a lot of confusion about Admin, Ops and Architecture guides. I guess we could really solve this issue through your talks at the summit. </div><div><br></div><div>What's Up Doc newsletter is awesome but it is confined to improve cross-communication in the OpenStack community. I think its really important to do this but this does not address new comers and googlers! Note: Not every end-user for manuals reads the ML's!</div><span><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div><div><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex">
I'm always up for new ideas, though :)</blockquote></div></div></div></div></blockquote><div><br></div></span><div>Kind of falling short of ideas here, but I am sure the community would come up with good creative ideas here. </div><div> </div><div>Regards,</div><div>Pranav</div></div><br></div></div>
<br></span><span>_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></span></blockquote></div><span><font color="#888888"><br><br clear="all"><div><br></div>-- <br><div data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>Anne Gentle</div><div><a href="http://www.justwriteclick.com" style="font-size:12.8px" target="_blank">www.justwriteclick.com</a><br></div></div></div></div></div>
</font></span></div></div>
</blockquote></div><br></div>
</div></div></blockquote></div></div></div><span class="HOEnZb"><font color="#888888"><br><br clear="all"><div><br></div>-- <br><div data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>Anne Gentle</div><div><a href="http://www.justwriteclick.com" style="font-size:12.8px" target="_blank">www.justwriteclick.com</a><br></div></div></div></div></div>
</font></span></div></div>
</blockquote></div><br></div>