<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"><br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;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><div>This is one of the bigger issues, apart from having confusion (from google's search results!) to linking to outdated documentation. 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. 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><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;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><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><div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;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><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">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><div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I'm always up for new ideas, though :)</blockquote></div></div></div></div></blockquote><div><br></div><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>