[OpenStack-docs] Install Guide planning

Andreas Jaeger aj at suse.com
Wed Dec 3 14:55:19 UTC 2014


On 12/03/2014 03:44 PM, Anne Gentle wrote:
> Hi all, 
> We want to do a real-time chat about the Install Guide and Matt and
> Thomas, Andreas and I can all make it at 19:00 UTC today, so we'll meet
> in #openstack-meeting-alt. Feel free to join us. The late notice was
> unavoidable this time, my apologies. I've added it to the OpenStack
> meeting calendar.
> 
> Agenda:
> Description of current state
> - OpenStack Install Guide is published four times from single source
> using conditional markup
> - OpenStack Install Guide is in the upstream translation system
> - there's a chapter about debconf for Debian configuration
> - DevStack is documented for Ubuntu 14.04 (Trusty), Fedora 20 and
> CentOS/RHEL 6.5 but not for OpenSuse or Debian

It works for openSUSE and SLES, I haven't checked the documentation quickly.

> - There are documented supported install tools outside of upstream such
> as RDO and Rackspace Private Cloud and Mirantis Fuel

and SUSE Cloud using Crowbar.

> Considerations when choosing path forward
> - Stated goals for upstream install guide

Let's write this one down at a prominent place

> - Audience analysis
> - Task analysis
> - Translations
> - Workload and resourcing
> - Tooling that enables conditionals
> - Packaging considerations and differences
> 
> Description of possible solutions
> - Continue with differences for Ubuntu/Debian
> - Make Debian OpenStack Install Guide same as Ubuntu, continue to
> publish Debian version
> - Stop publishing Debian version until someone is willing to make it
> like the rest of upstream
> - Create/maintain debconf/Debian guide outside of docs.openstack.org
> <http://docs.openstack.org>; continue publishing Debian version that
> matches other guides
>  - Something else we haven't brought to the list or thought of yet

Good list, thanks!

Andreas
-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF:Jeff Hawn,Jennifer Guild,Felix Imendörffer,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