<div dir="ltr"><div>Right now we have several docs to maintain, and users have several docs to sort through.  My observation of the issue has been that beginners don't know what they don't know. There has to be a way of lowering the barrier to entry without rendering the docs useless for people past their first deployment. In the context of this discussion I am talking about all of the guides, but not really the content. The content we have really is not that bad. I am more interested about how that content is found and presented to the user. </div><div><br></div><div>Is there a facility we can use that would just scope the docs to a point of view? Maybe like a tag in sphinx? </div><div><br></div><div><div>Docs and "cloudy understanding" have been the barrier to entry in Openstack for many shops for a long time, so its a great conversation for us to be having. </div><br class="gmail-Apple-interchange-newline"></div><div>~/Donny Davis</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, May 23, 2019 at 11:45 AM Stephen Finucane <<a href="mailto:sfinucan@redhat.com" target="_blank">sfinucan@redhat.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On Thu, 2019-05-23 at 10:33 -0500, Eric Fried wrote:<br>
> > Just to close this off, we never got to finish the application for<br>
> > this. It was quite involved, as promised, and Summit/PTG work took<br>
> > priority.<br>
> > Hopefully we'll be able to try again next year. Thanks to all who<br>
> > provided suggestions for things to work on.<br>
> <br>
> I assume this doesn't stop us from making docs a focus this release, and<br>
> from leaning on guidelines like:<br>
<br>
Not at all. This was just a chance to get even more eyes on this, but<br>
we should be able to make a good hand of this ourselves over the course<br>
of the cycle.<br>
<br>
> > I can only really speak for nova and oslo. For nova, I'd like to see<br>
> > us better align with the documentation style used in Django, which is<br>
> > described in the below article:<br>
> > <br>
> > <a href="https://jacobian.org/2009/nov/10/what-to-write/" rel="noreferrer" target="_blank">https://jacobian.org/2009/nov/10/what-to-write/</a><br>
> <br>
> As you know (but for others' awareness) Nova has a cycle theme for this<br>
> [1]. Just need some bodies to throw at it...<br>
> <br>
> efried<br>
> <br>
> [1]<br>
> <a href="https://review.opendev.org/#/c/657171/2/priorities/train-priorities.rst@37" rel="noreferrer" target="_blank">https://review.opendev.org/#/c/657171/2/priorities/train-priorities.rst@37</a><br>
> <br>
> <br>
<br>
<br>
</blockquote></div>