876af9be41
modified all existing files using xi:include that require the hierarchy to be striped out. dave cramer is super awesome. bug/1226775 Change-Id: Ic4618329e9a3b4de7cfdc91701678f34f7828a9a
46 lines
3.8 KiB
XML
46 lines
3.8 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<section 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="userstory-includes-template_version_1.1">
|
|
<title>Including external content for user stories, version 1.1</title>
|
|
<para>Save your user story file as associate-my-user-story-name, operator-my-user-story, etc. For
|
|
example my user story that I assigned myself is operator bug fix so the file name would be
|
|
operator-fix-documentation-bug.xml. See the operator-fix-documentation-bug.xml file in the
|
|
repository for more details.</para>
|
|
<para>The include statements below are meant to help you tell and teach the user story. Include as
|
|
much content as necessary. Use examples.</para>
|
|
<para>Create diagrams through gdraw. Export as png. Reference as local file in the /figures/
|
|
director. Share as 'Anyone With the Link' can 'Edit' and add URL to the description so anyone
|
|
else can update the original.</para>
|
|
<para>
|
|
<mediaobject><imageobject>
|
|
<imagedata fileref="figures/openstack-training-example-image.png" scale="20"/>
|
|
</imageobject></mediaobject>
|
|
big dummy example image</para>
|
|
<para>image source</para>
|
|
<para><link xlink:href="https://docs.google.com/drawings/d/1Tdn4SZLBdvQybW_nK_lO380YRIe5T6PsI0IyLH5XE3M/edit?usp=sharing">https://docs.google.com/drawings/d/1Tdn4SZLBdvQybW_nK_lO380YRIe5T6PsI0IyLH5XE3M/edit?usp=sharing</link></para>
|
|
|
|
<para><emphasis role="bold">Including a whole file. Include as much description about what is
|
|
being taught here.</emphasis></para>
|
|
<!-- this maps to cardXXX user story title "blah blah" -->
|
|
<xi:include href="../install-guide/basic-install-files/basic-install_architecture.xml"
|
|
xpointer="xmlns(db=http://docbook.org/ns/docbook) xpath(/*/*[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>
|
|
<para><link xlink:href="https://blueprints.launchpad.net/openstack-manuals/+filebug" xlink:show="new">Submit a bug on
|
|
the section above. Short description for the bug summary. Paragraph for the description and
|
|
then tag with training-manuals.</link></para>
|
|
|
|
<para><emphasis role="bold">Including a section of a file. Include as much description about
|
|
what is being taught here.</emphasis></para>
|
|
<!-- this maps to cardXXX user story title "blah blah" -->
|
|
<xi:include href="../install-guide/basic-install-files/basic-install_controller-common.xml"
|
|
xpointer="xmlns(db=http://docbook.org/ns/docbook) xpath(//*[@xml:id = 'controller-os']/*[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>
|
|
<para><link xlink:href="https://blueprints.launchpad.net/openstack-manuals/+filebug" xlink:show="new">Submit a bug on
|
|
the section above. Short description for the bug summary. Paragraph for the description and
|
|
then tag with training-manuals.</link></para>
|
|
</section> |