[Openstack-operators] [docs] An Ops CPL?

[Lana Brindley]

Hi everyone,

As you should already know, docs have a number of cross-project liaisons 
(CPLs)[1], which is basically a list of contact people from each project that 
docs can go to to ask subject matter questions. This is a great system, and we 
love being able to contact people directly to get answers.

However, it occurred to me recently that we don't have a central go-to person 
for Ops questions. This has come up a bit recently with the work we're doing on 
the Ops guide, but I've also noticed a few older bugs lurking in our queue that 
really need some solid Ops advice.

In short, I'd like to have an Ops docs liaison. It would give docs someone to 
go to to find out if we're doing it right, and it gives Ops a voice within docs 
and a way to help drive the way Ops documentation is created and maintained 
(and we have a lot of it these days!).

Any volunteers?

Thanks,
Lana 

1: https://wiki.openstack.org/wiki/CrossProjectLiaisons#Documentation

-- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com



signature.asc
Description: OpenPGP digital signature
___
OpenStack-operators mailing list
OpenStack-operators@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators

[Openstack-operators] Docs session in the Ops Track?

[Lana Brindley]

Hi Ops,

For the last few Design Summits, I've run a docs session in the Ops track, to 
focus on the Ops Guide (and, to a lesser extent, the Architecture Guide). Is 
there interest in doing this again? If so, can I please grab a slot?

Thanks,
Lana (Docs PTL)

-- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com



signature.asc
Description: OpenPGP digital signature
___
OpenStack-operators mailing list
OpenStack-operators@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators

Re: [Openstack-operators] Docs session in the Ops Track?

[Lana Brindley]

What do you mean by that? Can you please elaborate?

L

On 20/09/16 13:52, Matt Kassawara wrote:
> Can we focus on all of the potentially relevant documentation?
> 
> On Sun, Sep 18, 2016 at 5:34 PM, Lana Brindley <openst...@lanabrindley.com 
> <mailto:openst...@lanabrindley.com>> wrote:
> 
> Hi Ops,
> 
> For the last few Design Summits, I've run a docs session in the Ops 
> track, to focus on the Ops Guide (and, to a lesser extent, the Architecture 
> Guide). Is there interest in doing this again? If so, can I please grab a 
> slot?
> 
>     Thanks,
> Lana (Docs PTL)
> 
> --
> Lana Brindley
> Technical Writer
> Rackspace Cloud Builders Australia
> http://lanabrindley.com
> 
> 
> ___
> OpenStack-operators mailing list
> OpenStack-operators@lists.openstack.org 
> <mailto:OpenStack-operators@lists.openstack.org>
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators 
> <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators>
> 
> 

-- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com



signature.asc
Description: OpenPGP digital signature
___
OpenStack-operators mailing list
OpenStack-operators@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators

Re: [Openstack-operators] Docs session in the Ops Track?

[Lana Brindley]

That's probably more than we're able to focus on in a session, but if Ops have 
specific feedback on other docs, that session would be a good time for them to 
mention it. Otherwise, they can come to relevant sessions in the Docs track 
instead.

Lana

On 21/09/16 03:17, Matt Kassawara wrote:
> All relevant documentation for operators - which adds at least all of the 
> material under "Operations and Administration Guides" on d.o.o, the 
> configuration reference, and API reference.
> 
> On Tue, Sep 20, 2016 at 11:06 AM, Anne Gentle <annegen...@justwriteclick.com 
> <mailto:annegen...@justwriteclick.com>> wrote:
> 
> 
> 
> On Tue, Sep 20, 2016 at 12:01 PM, Matt Kassawara <mkassaw...@gmail.com 
> <mailto:mkassaw...@gmail.com>> wrote:
> 
> Operators use other documentation besides the operations guide, which 
> is arguably more of an overview for potential operators than current 
> operators. Same for the architecture guide.
> 
> 
> Hi -- You said "focus on all" -- can you be more specific what topics 
> you'd like? 
> 
> Plus, who has the ability to add to the ops track?
> 
> Anne
>  
> 
> 
> On Mon, Sep 19, 2016 at 10:01 PM, Lana Brindley 
> <openst...@lanabrindley.com <mailto:openst...@lanabrindley.com>> wrote:
> 
> What do you mean by that? Can you please elaborate?
> 
> L
> 
> On 20/09/16 13:52, Matt Kassawara wrote:
> > Can we focus on all of the potentially relevant documentation?
> >
> > On Sun, Sep 18, 2016 at 5:34 PM, Lana Brindley 
> <openst...@lanabrindley.com <mailto:openst...@lanabrindley.com> 
> <mailto:openst...@lanabrindley.com <mailto:openst...@lanabrindley.com>>> 
> wrote:
> >
> > Hi Ops,
> >
> > For the last few Design Summits, I've run a docs session in 
> the Ops track, to focus on the Ops Guide (and, to a lesser extent, the 
> Architecture Guide). Is there interest in doing this again? If so, can I 
> please grab a slot?
> >
> > Thanks,
> > Lana (Docs PTL)
> >
> > --
> > Lana Brindley
> > Technical Writer
> > Rackspace Cloud Builders Australia
> > http://lanabrindley.com
> >
> >
> > ___
> > OpenStack-operators mailing list
> > OpenStack-operators@lists.openstack.org 
> <mailto:OpenStack-operators@lists.openstack.org> 
> <mailto:OpenStack-operators@lists.openstack.org 
> <mailto:OpenStack-operators@lists.openstack.org>>
> > 
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators 
> <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators> 
> <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators 
> <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators>>
> >
> >
> 
> --
> Lana Brindley
> Technical Writer
> Rackspace Cloud Builders Australia
> http://lanabrindley.com
> 
> 
> 
> ___
> OpenStack-operators mailing list
> OpenStack-operators@lists.openstack.org 
> <mailto:OpenStack-operators@lists.openstack.org>
> 
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators 
> <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators>
> 
> 
> 
> 
> -- 
> Anne Gentle
> www.justwriteclick.com <http://www.justwriteclick.com>
> 
> 

-- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com



signature.asc
Description: OpenPGP digital signature
___
OpenStack-operators mailing list
OpenStack-operators@lists.openstack.org
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-operators