Documentation/ContentSharing

OpenStack Content Sharing

Requirements

• Non-proprietary OpenStack content resides in OpenStack repository. Includes substitution variables for product name, endpoints, and so on. Consumable by OpenStack and non-OpenStack consumers.
• Proprietary content resides in non-OpenStack repositories. Consumable by non-OpenStack consumers.
• Consumers include OpenStack source files and proprietary content in their books, as needed.
• When consumers generate output, they enter values for substitution variables. Ex: productname="Rackspace Cloud Servers"; endpoint="http://rackspacecloud.com"

Risks

• OpenStack source updates break non-OpenStack books that include that content.

Implementation

• Proof of concept: Verify possibility of cross-repository communication. Work out how to implement substitution variables.
• Determine which substitution variables are required. Product name? Endpoints? Version number?
• Update OpenStack source with substitution variables and publish these for public consumption.
• Update non-OpenStack book files to include OpenStack source.