netconn-api/v2.0/ch_neutron_preface.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter [
<!-- Some useful entities borrowed from HTML -->
<!ENTITY ndash  "&#x2013;">
<!ENTITY mdash  "&#x2014;">
<!ENTITY hellip "&#x2026;">
<!ENTITY plusmn "&#xB1;">

<!-- Useful for describing APIs -->
<!ENTITY GET    '<command xmlns="http://docbook.org/ns/docbook">GET</command>'>
<!ENTITY PUT    '<command xmlns="http://docbook.org/ns/docbook">PUT</command>'>
<!ENTITY POST   '<command xmlns="http://docbook.org/ns/docbook">POST</command>'>
<!ENTITY DELETE '<command xmlns="http://docbook.org/ns/docbook">DELETE</command>'>

<!ENTITY CHECK  '<inlinemediaobject xmlns="http://docbook.org/ns/docbook">
<imageobject>
<imagedata fileref="figures/Check_mark_23x20_02.svg"
format="SVG" scale="60"/>
</imageobject>
</inlinemediaobject>'>

<!ENTITY ARROW  '<inlinemediaobject xmlns="http://docbook.org/ns/docbook">
<imageobject>
<imagedata fileref="figures/Arrow_east.svg"
format="SVG" scale="60"/>
</imageobject>
</inlinemediaobject>'>
 <!ENTITY APIv2   'Networking (neutron) API v2.0'>
]>
<preface 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="ch_preface">
    <?dbhtml stop-chunking?>
    <title>Preface</title>
    <para>The OpenStack Networking (neutron) project provides virtual
        networking services among devices managed by the <link
            xlink:href="http://wiki.openstack.org/OpenStack"
            >OpenStack</link> compute service.</para>
    <para>This document describes the &APIv2; features.</para>
    <para>We welcome feedback, comments, and bug reports at <link
            xlink:href="http://bugs.launchpad.net/Neutron"
            >bugs.launchpad.net/Neutron</link>.</para>
    <section xml:id="Intended_Audience-d1e85">
        <title>Intended audience</title>
        <para xmlns:svg="http://www.w3.org/2000/svg"
            xmlns:m="http://www.w3.org/1998/Math/MathML"
            xmlns:html="http://www.w3.org/1999/xhtml"
            xmlns:db="http://docbook.org/ns/docbook">This guide is for
            software developers who create applications by using the
            &APIv2;. To use this information, you should have a
            general understanding of the OpenStack Networking service,
            the OpenStack compute service, and the integration between
            the two. You should also have access to a plug-in that
            implements the &APIv2;.</para>
        <para xmlns:svg="http://www.w3.org/2000/svg"
            xmlns:m="http://www.w3.org/1998/Math/MathML"
            xmlns:html="http://www.w3.org/1999/xhtml"
            xmlns:db="http://docbook.org/ns/docbook">You should also
            be familiar with:</para>
        <itemizedlist spacing="compact">
            <listitem>
                <para>ReSTful web services</para>
            </listitem>
            <listitem>
                <para>HTTP/1.1</para>
            </listitem>
            <listitem>
                <para>JSON and XML data serialization formats</para>
            </listitem>
        </itemizedlist>
    </section>
    <?hard-pagebreak?>
    <section xml:id="Document_Change_History-d1e118">
        <title>Document change history</title>
        <para>This version of the document replaces and obsoletes all
            previous versions. The following table describes the most
            recent changes:</para>
        <?rax revhistory?>
        <!-- Table generated in output from revision element in the book element -->
    </section>
    <?hard-pagebreak?>
    <section xml:id="Additional_Resources-d1e346">
        <title>Resources</title>
        <para>Use the following resources in conjunction with this
            guide:</para>
        <informaltable rules="all">
            <thead>
                <tr>
                    <th>Resource</th>
                    <th>See</th>
                </tr>
            </thead>
            <tbody>
                <tr>
                    <td>
                        <para>Related documents</para>
                    </td>
                    <td><link xlink:href="http://docs.openstack.org"
                            >OpenStack Documentation</link></td>
                </tr>
                <tr>
                    <td>
                        <para>OpenStack Neutron Wiki</para>
                    </td>
                    <td><link
                            xlink:href="http://wiki.openstack.org/Neutron"
                            >http://wiki.openstack.org/Neutron</link></td>
                </tr>
            </tbody>
        </informaltable>
    </section>
</preface>