Add stub files for new API Guide

Closes-Bug: #1269854

Change-Id: I01cc24ea65a69b5e1df532570a14de6f123e149f
author: Diane Fleming <diane.fleming@rackspace.com>
co-author: Miranda Zhang <miranda.zhang.q@gmail.com>
This commit is contained in:
Diane Fleming 2014-01-16 10:46:26 -06:00
parent 67bcf72a1f
commit 927b792371
7 changed files with 191 additions and 0 deletions

View File

@ -0,0 +1,64 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book [
]>
<book xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:xi="http://www.w3.org/2001/XInclude"
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" version="5.0"
xml:id="os-api-guide">
<title>OpenStack API Guide</title>
<titleabbrev>API Guide</titleabbrev>
<info>
<author>
<personname>
<firstname/>
<surname/>
</personname>
<affiliation>
<orgname>OpenStack Foundation</orgname>
</affiliation>
</author>
<copyright>
<year>2014</year>
<holder>OpenStack Foundation</holder>
</copyright>
<releaseinfo>local</releaseinfo>
<productname>OpenStack</productname>
<pubdate/>
<legalnotice role="cc-by">
<annotation>
<remark>Copyright details are filled in by the
template.</remark>
</annotation>
</legalnotice>
<abstract>
<para>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 is for developers who want to
extend the OpenStack APIs or write applications that
run on an OpenStack cloud. This guide introduces
developers to OpenStack API concepts, common tasks,
and ways of interacting with the APIs.</para>
</abstract>
<revhistory>
<revision>
<date>2014-01-30</date>
<revdescription>
<itemizedlist>
<listitem>
<para>First edition of this book.</para>
</listitem>
</itemizedlist>
</revdescription>
</revision>
</revhistory>
</info>
<xi:include href="ch_api_getting_started.xml"/>
<xi:include href="ch_api_limits.xml"/>
<xi:include href="ch_api_concepts.xml"/>
<xi:include href="ch_api_usage.xml"/>
</book>

View File

@ -0,0 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter [
]>
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:raxm="http://docs.rackspace.com/api/metadata" version="5.0"
xml:id="ch_api_concepts">
<info>
<title>API concepts</title>
</info>
<para></para>
</chapter>

View File

@ -0,0 +1,9 @@
<?xml version="1.0" encoding="utf-8"?>
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ch_api_overview">
<info>
<title>API overview</title>
</info>
<para></para>
</chapter>

View File

@ -0,0 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter [
]>
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:raxm="http://docs.rackspace.com/api/metadata" version="5.0"
xml:id="ch_api_limits">
<info>
<title>API limits</title>
</info>
<para></para>
</chapter>

View File

@ -0,0 +1,14 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter [
]>
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:raxm="http://docs.rackspace.com/api/metadata" version="5.0"
xml:id="ch_api_usage">
<info>
<title>Use the APIs</title>
</info>
<para>Provide tutorials, examples, interspersed with specific API
concepts?</para>
</chapter>

77
api-guide/pom.xml Normal file
View File

@ -0,0 +1,77 @@
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<parent>
<groupId>org.openstack.docs</groupId>
<artifactId>parent-pom</artifactId>
<version>1.0.0-SNAPSHOT</version>
<relativePath>../pom.xml</relativePath>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>openstack-api-guide</artifactId>
<packaging>jar</packaging>
<name>OpenStack API Guide</name>
<properties>
<!-- This is set by Jenkins according to the branch. -->
<release.path.name>local</release.path.name>
<comments.enabled>0</comments.enabled>
</properties>
<!-- ################################################ -->
<!-- USE "mvn clean generate-sources" to run this POM -->
<!-- ################################################ -->
<build>
<plugins>
<plugin>
<groupId>com.rackspace.cloud.api</groupId>
<artifactId>clouddocs-maven-plugin</artifactId>
<!-- version is set in ../pom.xml file -->
<executions>
<!-- Configuration for OpenStack End User Guide -->
<execution>
<id>os-api-guide</id>
<goals>
<goal>generate-webhelp</goal>
</goals>
<phase>generate-sources</phase>
<configuration>
<includes> bk-api-guide.xml</includes>
<generateToc>
appendix toc,title
article/appendix nop
article toc,title
book toc,title,figure,table,example,equation
chapter toc,title
section toc
part toc,title
qandadiv toc
qandaset toc
reference toc,title
set toc,title
</generateToc>
<targetDirectory>target/docbkx/webhelp</targetDirectory>
<webhelpDirname>api-guide</webhelpDirname>
<pdfFilenameBase>api-guide</pdfFilenameBase>
</configuration>
</execution>
</executions>
<configuration>
<chapterAutolabel>1</chapterAutolabel>
<sectionAutolabel>0</sectionAutolabel>
<tocSectionDepth>1</tocSectionDepth>
<formalProcedures>0</formalProcedures>
<highlightSource>false</highlightSource>
<xincludeSupported>true</xincludeSupported>
<showXslMessages>true</showXslMessages>
<sourceDirectory>.</sourceDirectory>
<security>external</security>
<branding>openstack</branding>
<enableDisqus>${comments.enabled}</enableDisqus>
<disqusShortname>os-api-guide</disqusShortname>
<enableGoogleAnalytics>1</enableGoogleAnalytics>
<googleAnalyticsId>UA-17511903-1</googleAnalyticsId>
<suppressFooterNavigation>0</suppressFooterNavigation>
</configuration>
</plugin>
</plugins>
</build>
</project>

View File

@ -10,6 +10,7 @@
<modules>
<module>api-quick-start</module>
<module>api-guide</module>
<module>api-ref</module>
<!-- <module>api-ref-books</module>-->
</modules>