Bug 1038335

Summary: [Doc] The "Configuring the Networking Service" section should be split up
Product: Red Hat OpenStack Reporter: Don Domingo <ddomingo>
Component: doc-Installation_and_Configuration_GuideAssignee: Don Domingo <ddomingo>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: low Docs Contact:
Priority: unspecified    
Version: 4.0CC: mlopes, yeylon
Target Milestone: z1Keywords: Documentation
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: 2015-02-16 03:26:03 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: 1009641    
Bug Blocks: 1049118    

Description Don Domingo 2013-12-04 22:53:38 UTC 
Description of problem:

The configuration sections of all the other OpenStack components are split up into different sections (keystone token config, message broker setup, db connect string, etc). The Networking one is not.

This makes cross-linking harder, since there's currently no logical way to link to a specific subsection there other than to link to the page itself and spell out the specific step. In addition, adding a prereq/xref specific to a certain step is not as intuitive, since links are done at the topic level. 

Noticed this problem while doing BZ#1009641, when I needed to associate the "Setting the Message Broker" step of Neutron to the "Configure SASL using a Local Password File" procedure.

https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/4-Beta/html/Installation_and_Configuration_Guide/Configuring_the_Networking_Service1.html