This github repository contains the source files for the following Rackspace Cloud Files API documentation:
Contributions are welcome! To suggest changes to the documentation, submit an issue or a pull request.
To make changes to a project, create your own fork of the project and send a pull request to have your changes reviewed and merged into the master branch as appropriate.
This repository uses Maven to generate the output documentation. Command line users can generate the complete output from this repository by using the following command:
mvn clean generate-sources
The output appears in PDF and HTML form in the following locations. The items in the Name column link to the location where the documentation is published, when available.
Name | Build Location |
---|---|
Getting Started Guide | target/docbkx/webhelp/cf-getting-started-external |
Developer Guide | target/docbkx/webhelp/cf-devguide-external |
Release Notes | target/docbkx/webhelp/cf-releasenotes-external |
You can use any text editor to work with these source files. If you want to use an IDE, consider NetBeans. This cross-platform IDE offers seamless support for Maven projects and does not require additional configuration to open the pom.xml file as a project. You can configure the project so that the Build command, which appears when you right-click a project in the Projects pane, executes the clean generate-sources
command. To do so, perform the following steps:
- Right-click the project in the Projects pane and select Properties.
- Select the Build category in the left pane, and then select the Build project action in the right pane.
- Change Execute Goals to
clean generate-sources
. - (Optional) Repeat steps 2 and 3 for the Clean and Build project and Build with Dependencies actions.
The files that are most likely to be of interest to you are as follows:
- src/docbkx/cf-getting-started.xml
- src/docbkx/cf-devguide.xml
- src/wadl/rax-cloudFiles-api-v1.wadl
- src/wadl/rax-cloudFilesCDN-api-v1.wadl
If you want to make changes to the example files referenced in the WADL file, you can find the example files at src/wadl/samples.
The status codes referenced by the WADL files are at src/resources/wadl/common.ent.