openstack/openstack-manuals
Code Issues Proposed changes
1d75d9ec43
openstack-manuals/doc/training-guides/bk000-preface.xml
Shilla Saebi 73bcc6e004 Cleaned up bk000-preface 
Changed sentences to make sense
added transition words where necessary

Change-Id: I760f0c0cc8d19bd1f4b1a6e8af6c991f65f5c90b
2014-01-03 13:21:32 -05:00

152 lines
10 KiB
XML
Raw Blame History

<?xml version="1.0" encoding="UTF-8"?>
<book xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
xml:id="bk001-preface">
<title>Start Here</title>
<preface xml:id="preface">
<title>Preface</title>
<?dbhtml stop-chunking?>
<xi:include href="../common/section_dochistory.xml"/>
</preface>
<appendix xml:id="under-construction">
<title>OpenStack Training Guides Are Under Construction</title>
<para>We need your help! This is a community driven project to provide the user group community
access to OpenStack training materials. We cannot make this work without your help.</para>
<para>There are a few ways to get involved. The easiest way is to use the training guides. Look at
the end of each section and you will see the Submit a Bug link. When you find something that can
be improved or fixed, submit a bug by clicking on the link.</para>
<para>If you want to get involved with the effort around OpenStack community training, read on,
here are the options:</para>
<para>
<itemizedlist>
<listitem>
<formalpara><title>Attending a user group using the training materials</title>
<para>The OpenStack community training started at the SFBay OpenStack User Group. More
information on this user group and others using the training guides on the <link
xlink:href="https://wiki.openstack.org/wiki/OpenStackUserGroups">OpenStack User Groups
page</link>.</para>
</formalpara>
</listitem>
<listitem>
<formalpara><title>Teach / Lead a user group using the training materials</title>
<para>Awesome! Your experience will not only give you more experience with OpenStack, but
you will help some people find new jobs. We have put all the information about <link
xlink:href="https://wiki.openstack.org/wiki/OpenStackUserGroups/HowTo#Running_a_Hackathon"
>How To Run An OpenStack Hackathon</link> here.</para></formalpara>
</listitem>
<listitem>
<formalpara>
<title>Help create the training pages</title>
<para>
<itemizedlist>
<listitem>
<para>We are currently working on creating the Associate Training Guide. It is the
first of four training guides. We are using the Install Guide, Administration
Guides, Developer Documentation, and Aptira supplied content as the sources for
most of the Associate Training Guide. The basic idea is that we use XML include
statements to actually use the source content to create new pages. We aim to use
as much of the material as possible from existing documentation. By doing this
we reuse and improve the existing docs. The topics in the Associate Training
Guide are in a bunch of KanBan story board cards. Each card in the story board
represents something that an Associate trainee needs to learn. But first things
first, you need to get some basic tools and accounts installed and configured
before you can really start.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Getting Accounts and Tools:</emphasis> We can't do
this without operators and developers using and creating the content. Anyone can
contribute content. You will need the tools to get started. Go to the <link
xlink:href="operator-getting-started-lab.html#getting-tools-and-accounts"
>Getting Tools and Accounts</link> page.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Pick a Card:</emphasis> Once you have your tools ready
to go, you can assign some work to yourself. Go to the <link
xlink:href="https://trello.com/board/openstack-training/51d6e5fee37248fd5b003de9"
>Training Trello/KanBan storyboard</link> and assign a card / user story from
the Sprint Backlog to yourself. If you do not have a Trello account, no problem,
just create one. Email seanrob@yahoo-inc.com and you will have access.</para>
</listitem>
<listitem>
<para><emphasis role="bold">Create the Content:</emphasis> Each card / user story
from the KanBan story board will be a separate chunk of content that you will
add to the openstack-manuals repository openstack-training sub-project.
<link xlink:href="operator-getting-started-lab.html#operator-add-training-content">
More details on creating training content here.</link></para>
</listitem>
</itemizedlist>
</para>
</formalpara>
<note>
<para>Here are more details on commiting changes to OpenStack <link
xlink:href="operator-getting-started-lab.html#submit-doc-bug">fixing a documentation bug</link>
, <link xlink:href="https://wiki.openstack.org/wiki/Gerrit_Workflow">OpenStack Gerrit
Workflow</link>, <link xlink:href="https://wiki.openstack.org/wiki/Documentation/HowTo">OpenStack
Documentation HowTo</link> and , <link xlink:href="http://git-scm.com/doc">Git Documentation</link></para>
</note>
</listitem>
</itemizedlist>
</para>
<para>More details on the OpenStack Training project.</para>
<para>
<orderedlist>
<listitem>
<para><link xlink:href="https://wiki.openstack.org/wiki/Training-manuals">OpenStack Training
Wiki</link> (describes the project in detail)</para>
</listitem>
<listitem>
<para><link
xlink:href="https://blueprints.launchpad.net/openstack-manuals/+spec/training-manuals"
>OpenStack Training blueprint</link>(this is the key project page)</para>
</listitem>
<listitem>
<para><link xlink:href="http://www.meetup.com/openstack/">Bi-Weekly SFBay Hackathon meetup
page</link>(we discuss project details with all team members)</para>
</listitem>
<listitem>
<para><link xlink:href="https://etherpad.openstack.org/sfbay-openstack">Bi-Weekly SFBay
Hackathon Etherpad</link>(meetup notes)</para>
</listitem>
<listitem>
<para><link xlink:href="https://wiki.openstack.org/wiki/Meetings/training-manuals">Core
Training Weekly Meeting Agenda</link>(we review project action items here)</para>
</listitem>
<listitem>
<para><link
xlink:href="https://trello.com/board/openstack-training/51d6e5fee37248fd5b003de9"
>Training Trello/KanBan storyboard</link>(we develop high level project action items
here)</para>
</listitem>
</orderedlist>
</para>
<para><link xlink:href="https://blueprints.launchpad.net/openstack-manuals/+filebug" xlink:show="new">Submit a bug. Enter the summary as "Training, " with a few words. Be descriptive as possible in the description field. Open the tag pull-down and enter training-manuals.</link>
</para>
</appendix>
<appendix xml:id="building-training-cluster">
<title>Building the Training Cluster</title>
<?dbhtml stop-chunking?>
<section xml:id="important-terms">
<title>Important Terms</title>
<xi:include href="./lab000-important-terms.xml"
xpointer="xmlns(db=http://docbook.org/ns/docbook) xpath(//*[@xml:id = 'lab000-important-terms']/*[not(self::db:title)])">
<xi:fallback><para><mediaobject><imageobject><imagedata fileref="figures/openstack-training-remote-content-not-available.png" format="PNG"/></imageobject></mediaobject>Remote content not available</para><para>image source</para><para><link xlink:href="https://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing">https://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing</link></para></xi:fallback>
</xi:include>
</section>
<section xml:id="virtualbox-scripted">
<title>Building the Training Cluster, Scripted</title>
<xi:include href="./training-cluster-by-script.xml"
xpointer="xmlns(db=http://docbook.org/ns/docbook) xpath(//*[@xml:id = 'training-cluster-by-script']/*[not(self::db:title)])">
<xi:fallback><para><mediaobject><imageobject><imagedata fileref="figures/openstack-training-remote-content-not-available.png" format="PNG"/></imageobject></mediaobject>Remote content not available</para><para>image source</para><para><link xlink:href="https://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing">https://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing</link></para></xi:fallback>
</xi:include>
</section>
<section xml:id="virtualbox-manual">
<title>Building the Training Cluster, Manually</title>
<xi:include href="./lab000-virtualbox-basics.xml"
xpointer="xmlns(db=http://docbook.org/ns/docbook) xpath(//*[@xml:id = 'lab000-virtualbox-basics']/*[not(self::db:title)])">
<xi:fallback><para><mediaobject><imageobject><imagedata fileref="figures/openstack-training-remote-content-not-available.png" format="PNG"/></imageobject></mediaobject>Remote content not available</para><para>image source</para><para><link xlink:href="https://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing">https://docs.google.com/drawings/d/1J2LZSxmc06xKyxMgPjv5fC0blV7qK6956-AeTmFOZD4/edit?usp=sharing</link></para></xi:fallback>
</xi:include>
</section>
</appendix>
<xi:include href="../common/app_support.xml"/>
</book>
View Git Blame Copy Permalink