Bug 867138 - 5.2.2 Configure Socket Bindings - Title of Table 5.2 is confusing.
Summary: 5.2.2 Configure Socket Bindings - Title of Table 5.2 is confusing.
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: JBoss Enterprise Application Platform 6
Classification: JBoss
Component: Documentation
Version: 6.0
Hardware: All
OS: All
unspecified
low
Target Milestone: ---
: EAP 6.1.0
Assignee: Tom WELLS
QA Contact: Russell Dickenson
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2012-10-16 20:51 UTC by Dillon Winchell
Modified: 2015-05-18 01:28 UTC (History)
3 users (show)

Fixed In Version:
Clone Of:
Environment:
Instance Name: Not Defined Build: CSProcessor Builder Version 1.7 Build Filter: null Build Name: 8740, Administration and Configuration Guide-6-2 Build Date: 09-10-2012 17:00:37
Last Closed: 2013-05-24 00:28:31 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)

Description Dillon Winchell 2012-10-16 20:51:35 UTC
Description of problem:
The title of Table 5.2, at the top of https://access.redhat.com/knowledge/docs/en-US/JBoss_Enterprise_Application_Platform/6/html/Administration_and_Configuration_Guide/Configure_Socket_Bindings.html, reads "Table 5.2 Socket Binding Group Structure".

Section 5.2.2, at the top of which the table appears, contains information on configuring individual socket bindings. The previous section gave an overview of the enclosing structure, the Socket Binding Group. The table itself lists attributes of Socket Bindings, not Groups. This might be a copy paste error.

The title is not entirely unreasonable, since the attributes listed do apply to children of Socket Binding Groups, but I think it's confusing. It gives the impression that you're going to find attributes of the Socket Binding Group in the table. I had to puzzle through the attribute descriptions before I figured it out.

Version-Release number of selected component (if applicable):
Revision 0.0-12 	Tue Oct 09 2012 

How reproducible:
Read the caption at the top of Table 5.2. The table is at the top of https://access.redhat.com/knowledge/docs/en-US/JBoss_Enterprise_Application_Platform/6/html/Administration_and_Configuration_Guide/Configure_Socket_Bindings.html

Steps to Reproduce:
1. Browse to https://access.redhat.com/knowledge/docs/en-US/JBoss_Enterprise_Application_Platform/6/html/Administration_and_Configuration_Guide/Configure_Socket_Bindings.html.
  
Actual results:
Title reads "Table 5.2 Socket Binding Group Structure"

Expected results:
Something like "Table 5.2 Socket Binding Structure", that does not give the impression the attributes apply to Groups.

Additional info:
This is a minor nit, and subjective. Feel free to ignore.

Comment 1 Tom WELLS 2012-10-26 06:08:06 UTC
Hey Dillon,

I completely agree - the table title does add confusion to the topic. I will change it to "Socket Binding Attributes".

Thanks for raising this issue,

Tom Wells


Note You need to log in before you can comment on or make changes to this bug.