[Openstack-docs] Target audience

Andreas Jaeger aj at suse.com
Mon May 19 20:41:01 UTC 2014


We had some discussion about target audience for each guide at the
OpenStack summit and Anne filed this bug:
https://bugs.launchpad.net/openstack-manuals/+bug/1319394 . As a first
step, I've went over all guides and categorized them according to target
audience and then copied all the current abstracts together. Is the
following accurate?

Andreas

Overview of personas/target audience:

Operations Guide
Cloud Administrator Guide
Configuration Reference
HA Guide
Install Guide
Security Guide
Admin User Guide

These guides target cloud administrators who sets up an OpenStack
cloud and configures the OpenStack services.

End User Guide
Image Guide

These guide targets users using an OpenStack cloud.

CLI Reference

This guide targets both cloud administrators and users using an
OpenStack cloud.

Not covered personas:

Developer writing applications running in an OpenStack Cloud.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Detailed information - copy of current abstract:

Install Guide

The OpenStack® system consists of several key projects that you
install separately but that work together depending on your cloud
needs. These projects include Compute, Identity Service, Networking,
Image Service, Block Storage, Object Storage, Telemetry,
Orchestration, and Database. You can install any of these projects
separately and configure them stand-alone or as connected
entities. This guide shows you how to install OpenStack by using
packages on openSUSE through the Open Build Service Cloud
repository. Explanations of configuration options and sample
configuration files are included.


Operations Guide

This book provides information about designing and operating OpenStack
clouds.

Cloud Administrator Guide

OpenStack offers open source software for cloud administrators to
manage and troubleshoot an OpenStack cloud.

Configuration Reference

This document is for system administrators who want to look up
configuration options. It contains lists of configuration options
available with OpenStack and uses auto-generation to generate options
and the descriptions from the code for each project. It includes
sample configuration files.

HA Guide

No abstract given.

Security Guide

This book provides best practices and conceptual information about
securing an OpenStack cloud.

Admin User Guide

OpenStack is an open source cloud computing platform for public and
private clouds. A series of interrelated projects deliver a cloud
infrastructure solution. This guide shows OpenStack admin users how to
create and manage resources in an OpenStack cloud with the OpenStack
dashboard or OpenStack client commands.


End User Guide

OpenStack is an open-source cloud computing platform for public and
private clouds. A series of interrelated projects deliver a cloud
infrastructure solution. This guide shows OpenStack end users how to
create and manage resources in an OpenStack cloud with the OpenStack
dashboard and OpenStack client commands.

Image Guide

This guide describes how to obtain, create, and modify virtual machine
images that are compatible with OpenStack.

CLI Reference

This guide documents the OpenStack command-line clients.

-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126



More information about the Openstack-docs mailing list