openstack-doc-core team mailing list archive

[Tom Fifield <fifieldt@xxxxxxxxxxxxxx>]

For reference, I'm fine with either, provided it's thought through or 
even better ... consistent :)

Assisting troubleshooting is an important role, and an "anemic" chapter 
is a sad, sad thing :)

Of course, with our excellent re-use-loving structuring of chapters, it 
should be possible to even do both if needed or swap in the future ...

Regards,

Tom

(this email is sent at 4am local time, and may contain Australian lingo 
or not make sense)

On 13/07/12 01:08, Anne Gentle wrote:
> I like troubleshooting info very close to the topic it addresses. It's
> also good to pull common errors into one place.
>
> Anne Gentle
> Content Stacker
> anne@xxxxxxxxxxxxx <mailto:anne@xxxxxxxxxxxxx>
>
>
> On Jul 12, 2012, at 9:45 AM, Lorin Hochstein <lorin@xxxxxxxxxxxxxxxxxx
> <mailto:lorin@xxxxxxxxxxxxxxxxxx>> wrote:
>
> > (crossposting to doc-core in case not everyone there has moved over to
> > openstack-docs yet).
> >
> > A question came up on this merge proposal:
> > https://review.openstack.org/9494
> >
> > In that proposal, I had created a "troubleshooting" section in the
> > Networking chapter in the Compute Admin guide. Tom pointed out that we
> > already have a whole Troubleshooting chapter and asked whether it made
> > sense to just keep it in one place or split it across sections. I
> > wanted to bring it up to the list to see what people thought.
> >
> > I liked having it by section to have the Networking troubleshooting
> > docs closer to the rest of the networking content. But I can imagine
> > troubleshooting issues where it would deal with issues across multiple
> > sections (e.g., some interaction between scheduling and VMs, for
> > example), in which case that would make it harder to find the right
> > content, since a reader might miss the troubleshooting section that
> > solves their problem.
> >
> > Also, right now the OpenStack Compute Troubleshooting chapter is
> > pretty anemic
> > <http://docs.openstack.org/essex/openstack-compute/admin/content/common-errors-and-fixes-for-openstack-compute.html>.
> > Whatever we do, we should probably start populating that with fixes to
> > common issues in better detail.
> >
> > Take care,
> >
> > Lorin
> > --
> > Lorin Hochstein
> > Lead Architect - Cloud Services
> > Nimbis Services, Inc.
> > www.nimbisservices.com <https://www.nimbisservices.com/>
> >
> >
> >
> >
> >
> > --
> > Mailing list: https://launchpad.net/~openstack-doc-core
> > Post to     : openstack-doc-core@xxxxxxxxxxxxxxxxxxx
> > <mailto:openstack-doc-core@xxxxxxxxxxxxxxxxxxx>
> > Unsubscribe : https://launchpad.net/~openstack-doc-core
> > More help   : https://help.launchpad.net/ListHelp