Open Stack

Thanks, Chason!

Being spurred on by this conversation, I’ve started up another patch: https://review.openstack.org/#/c/407508/ Removing some of the content that was simply blank, and moving some things around with the occasional cursory edit.

Reviews very welcome ☺

Cheers,

Alex

From: Chason <chen.xing at 99cloud.net>
Date: Tuesday, December 6, 2016 at 4:57 AM
To: Alexandra Settle <a.settle at outlook.com>, Andrew Beekhof <abeekhof at redhat.com>, Lana Brindley <openstack at lanabrindley.com>
Cc: openstack-docs <openstack-docs at lists.openstack.org>, "aspiers at suse.com" <aspiers at suse.com>
Subject: Re: Re: Future of the HA Guide?

I have the same opinion with Alex. It is still worthwhile to keep HA guide in publication. I am looking forward to the spec and willing to get involved in this improving job. : )

Thanks,

Chason

From: Alexandra Settle<mailto:a.settle at outlook.com>
Date: 2016-12-06 17:47
To: Andrew Beekhof<mailto:abeekhof at redhat.com>; Lana Brindley<mailto:openstack at lanabrindley.com>
CC: OpenStack Manuals<mailto:openstack-docs at lists.openstack.org>; chen.xing at 99cloud.net<mailto:chen.xing at 99cloud.net>; aspiers at suse.com<mailto:aspiers at suse.com>
Subject: Re: Future of the HA Guide?
Hey Andrew, Hey Lana,

So, I only have one minor patch left in flight, see here: https://review.openstack.org/#/c/406882/

After extensively reviewing the guide over the last two weeks I do believe it has some highly beneficial content and, now that Lana has the numbers to justify it, I sincerely believe we should keep this guide in publication.

However, it can no longer go ignored as a background guide. There are chapters, such as this one http://docs.openstack.org/ha-guide/networking-ha.html, that literally have next to no information on it. It is a file of publicly visible TODOs. I have filed numerous bugs here: https://bugs.launchpad.net/openstack-manuals/+bugs?field.tag=ha-guide based mostly out of the TODOs I found in the guide.

Thank you, Chen, for filing the blueprint. If someone has the time (and I have CC’d in Adam Spiers who also works on HA ‘stuff’ to hopefully find such a person) to go through the bugs and find what is still relevant to the guide – and then perhaps we can go ahead and write a specification based of the plans from Andrew.

TL;DR - If we can get the blueprint (and bugs) reviewed for relevant content, we can create the spec, and then maybe discuss a potential sprint in the near future.

Cheers,

Alex

On 12/6/16, 3:53 AM, "Andrew Beekhof" <abeekhof at redhat.com> wrote:

    I have no spec for this, but my plan has been to par back the guide to
    the essentials.
    Most OpenStack services no longer need any hand-holding from a cluster
    manager and don't need to be covered.

    Instead I think the guide should:
    1. outline and justify an architecture
    2. show how to configure shared services for HA, such as haproxy,
    galera, rabbitmq
    3. explain in general how to configure openstack services to use the
    shared services (haproxy for galera, node list for rabbit, etc)
    4. explain how to accomodate any active-passive services (ie. cinder-volume)

    I (now) have most of this information ready in another context, what
    remains is to shape it into a suitable format for the guide.
    I might be able to find a few days for this before christmas if that
    would help, but it would be good to have Alexandra's efforts completed
    first least we end up with a tonne of merge conflicts.

    -- Andrew




    On Tue, Dec 6, 2016 at 2:32 PM, Lana Brindley
    <openstack at lanabrindley.com> wrote:
    > Hi everyone,
    >
    > Seems that the HA Guide is rearing its ugly head again at the moment. It's not had a lot of attention in the past year or so, so it's gotten more and more out of date. Under the guidance of Andrew Beekhof, it's slowly improving, and Alexandra Settle has been putting in a lot of effort recently, however it's time we decided whether or not it's worth overhauling the guide. At the moment, we have an unapproved blueprint here: https://blueprints.launchpad.net/openstack-manuals/+spec/implement-ha-guide-todos
    >
    > So, what do you think? We know that a fair few people are looking at it (the HA Guide had 1,621 visitors in the last 30 days. Compare that to the Ubuntu Newton Install Guide which got 3,426 or the Ops Guide at 1,547 in the same period), but it's important that if people are accessing the information that it's accurate, and we already know the HA Guide is not current. Is it better to have it there and possibly incorrect, or to remove it entirely? Can we subsume any good content in the HA Guide into another guide (or guides)?
    >
    > I want to make sure we have a clear direction on this guide before we commit resources to improving it. So, ideas please, before the book gets consigned to the recycling bin!
    >
    > L
    >
    > --
    > Lana Brindley
    > Technical Writer
    > Rackspace Cloud Builders Australia
    > http://lanabrindley.com
    >


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20161206/45e14e6c/attachment-0001.html>