Bug 974236

Summary: Remove Sample Configuration File topics, add references to Configuration Reference Guide
Product: Red Hat OpenStack Reporter: Stephen Gordon <sgordon>
Component: doc-Installation_and_Configuration_GuideAssignee: Summer Long <slong>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: medium Docs Contact:
Priority: medium    
Version: 3.0CC: mlopes
Target Milestone: ---Keywords: Documentation, Triaged
Target Release: 4.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2014-01-06 22:08:49 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1011085    

Description Stephen Gordon 2013-06-13 18:37:56 UTC 
The ICG contains a number of sample configuration files as appendices. In many cases the upstream git project for each component also contains sample configuration files. To make future maintenance easier it would be desirable to automate generation of the appendices from the upstream git repositories.

I believe some work to achieve this may already be occurring in the openstack-manuals project but either way the process should be relatively simple. We would probably need to maintain a mapping like:

topicid,project,file
Comment 1 Stephen Gordon 2013-09-24 18:42:18 UTC 
This content will now appear in the Configuration Reference Guide.
Comment 3 Summer Long 2013-11-18 03:19:07 UTC 
Added new topic 'Additional Documentation' - 25104, and added into the Installation Guide spec.
Comment 4 Summer Long 2013-11-20 02:10:16 UTC 
Review and reworks have been done, and merged. Ready for QA when new packages for CRG and ICG have been posted.
Comment 5 Summer Long 2013-11-21 07:09:53 UTC 
*** Bug 974792 has been marked as a duplicate of this bug. ***
Comment 6 Summer Long 2013-12-12 05:22:42 UTC 
For QE, the Configuration Reference Guide is here:
http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/4/html-single/Configuration_Reference_Guide/index.html

Installation Reference Guide:
http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/4/html-single/Installation_and_Configuration_Guide/index.html

Here is the Additional Documentation section in the ICG:
http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/4/html-single/Installation_and_Configuration_Guide/index.html#Additional_Documentation1