openstack/openstack-manuals
Code Issues Proposed changes

Edits to the introduction for clarity

Browse Source 
Reworded and removed unnecessary content
Post docs swarm cleanup of the arch guide

Change-Id: I91f449751a4d2ae1133b1ced49799a740e380c09
This commit is contained in:
asettle 2015-08-27 13:51:41 +10:00 committed by Alexandra Settle
parent 4a9d5c0ab2
commit 667dc82899
2 changed files with 9 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
doc/arch-design/introduction/section_how_this_book_was_written.xml
View File

@ -5,21 +5,18 @@
version="5.0"
xml:id="arch-guide-why-and-who-we-wrote-this-book">
<title>Why and how we wrote this book</title>
<para>We wrote this book to guide you in designing an OpenStack cloud
architecture that meets the needs of your organization. This guide
identifies important design considerations for common cloud use cases
and provides examples.</para>
<para>This book was written in a book sprint format, which is a
facilitated, rapid development production method for books.
For more information, see the Book Sprints website
<para>We wrote this book to guide you through designing an OpenStack cloud
architecture. This guide identifies design considerations
for common cloud use cases and provides examples.</para>
<para>The Architecture Design Guide was written in a book sprint format,
which is a facilitated, rapid development production method for books.
The Book Sprint was facilitated by Faith Bosworth and Adam
Hyde of Book Sprints, for more information, see the Book Sprints website
(www.booksprints.net).</para>
<para>This book was written in five days during July 2014 while
exhausting the M&amp;M, Mountain Dew and healthy options
supply, complete with juggling entertainment during lunches at
VMware's headquarters in Palo Alto. The event was also
documented on Twitter using the #OpenStackDesign hashtag. The
Book Sprint was facilitated by Faith Bosworth and Adam
Hyde.</para>
VMware's headquarters in Palo Alto.</para>
<para>We would like to thank VMware for their generous
hospitality, as well as our employers, Cisco, Cloudscaling,
Comcast, EMC, Mirantis, Rackspace, Red Hat, Verizon, and

2
doc/arch-design/introduction/section_intended_audience.xml
View File

@ -11,7 +11,7 @@
Guide</citetitle> (<link
xlink:href="http://docs.openstack.org/openstack-ops">http://docs.openstack.org/openstack-ops</link>).
</para>
<para>The reader should have prior knowledge of cloud architecture
<para>Before reading this book, we recommend prior knowledge of cloud architecture
and principles, experience in enterprise system design, Linux
and virtualization experience, and a basic understanding of
networking principles and protocols.</para>