Open Stack

annegentle at justwriteclick.com wrote on 07/17/2014 08:19:57 AM:

> I've been starting to think that there ought to be various
> infrastructure (or an "under the covers")
> guides, because I've been finding places where, while the existing
> documentation is essentially correct,
> they are incomplete in terms of the details of what exactly is happening.

>
> Adding such details would risk cluttering up the existing document
> (as you've noted) and such
> a set of guides could both provide deeper insight into how
> particular components work and provide
> a natural landing space for documentation such as this.

>
> Ryan, who's the audience for this type of under the covers doc? Are
> they likely to read the code anyway to get the real story? It's
> difficult to keep up with the under the covers story -- especially
> when we don't have full coverage on the covers. :)

I wasn't thinking of developers (I hope that they'll be reading the code),
but more the folks in quality assurance/testing/field support who likely
won't have the time to RTSC but need to some understanding of what is
happening when a particular command is issued or operation is performed.

Yes, I understand the coverage problem :( - that's why I'm still in the
"starting
to think" mode and wondering how useful this would be.

Ryan
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140717/2daf06d8/attachment.html>