[OpenStack-docs] Report from Austin: Ops Guide Session

Andreas Jaeger aj at suse.com
Tue Apr 26 11:36:45 UTC 2016


On 04/25/2016 02:20 PM, Lana Brindley wrote:
> Hi everyone!
>
> I joined the Ops Guide session at Summit this morning, where we were discussing whether or not the Ops Guide needs a new version.
>
> Session etherpad: https://etherpad.openstack.org/p/AUS-ops-Docs-ops-guide
>
> Here's my notes:
>
> Content:
> * Ops/Arch guide overlap
> * Content is currently persona-based, should be task-based
> * Need to be able to use search to find content
> * Need to determine which tasks should be documented. Need ops volunteers to help with this.
> * Do we need both books? Once we have decided tasks, we can determine this.
>
> Should we print a new dead tree version?
> * Out of date easily
> * Plenty of other physical books exist in this space now.
> * Decided: no physical book required.
>
> Priorities:

As discussed, let's add:

* Finish migration to RST
> * Attend weekly Openstack Ops meeting (cycling topics)
> * Get tasks sorted out for new structure (need Ops volunteers to help) and work out what to go into Ops/Arch
> * Work out what's out of date and torch it
> * Consider combining Ops/Arch guides if the content determines it

thanks,
Andreas
-- 
  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
   SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
    GF: Felix Imendörffer, Jane Smithard, Graham Norton,
        HRB 21284 (AG Nürnberg)
     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126




More information about the OpenStack-docs mailing list