Red Hat Bugzilla – Bug 850885
Docs: Minor errors in the Reference Guide
Last modified: 2015-08-09 21:27:27 EDT
Description of problem:
Issue for keeping track of minor errors in the Reference Guide (grammar mistakes, typos etc.), see the comments for more details.
Chapters 1-13 (mostly grammar mistakes, listed by sections):
2.6. The Default Skin
and well as defining -> as well as defines
eXoResources.war will contains -> eXoResources.war will contain
numbbering in the code sample goes outside the sample (4)
18.104.22.168. Define a Custom CSS File
to create non-functioning a CSS-link -> to create a non-functioning CSS-link
ownerType define the type of portal navigation. It may be a portal, group or user -> ownerType defines the type of portal navigation. It may be a portal, group or user.
templateLocation the classpath where contains -> templateLocation defines the classpath containing
stored in folders with path look like -> stored in folders with path looking like
xml:lang attribute in the label tag with value of xml:lang is the relevant locale -> xml:lang attribute in the label tag where value of xml:lang is the relevant locale
if they want the node label is localized -> if they want the node label to be localized
In the Portal extension mechanism, developers can define an extension that Portal data can be customized by configurations in the extension. -> looks like something is missing here
There are several cases which an extension developer wants to define how to customize the Portal data -> something missing in the sentence?
7.2.1. Portal Configuration
how the import mode affects in the process -> how the import mode affects the process
7.2.2. Page Data
The import mode affects the page data import in the same way as PortalConfig.
the data import strategy always performs as -> the data import strategy always acts as
7.2.3. Navigation Data
The navigation data import strategy will be processed to the import mode level as the followings: -> The navigation data import strategy is processed at the import mode level in the following way:
Other modifications remains untouched. -> Other modifications remain untouched.
update same name nodes -> update existing nodes
component of JBoss Enterprise Portal Platform that process -> component of JBoss Enterprise Portal Platform that processes
a request contain data -> a request contains data
13.2.2. Building Controller
route the request argument through the controller and returns a list of all parameter map resolution
13.2.3. Controller Configuration (controller.xml)
a tree of node -> a tree of nodes
three kind of -> three kinds of
22.214.171.124. Route parameters
Route parameters defines a fixed value associate with a qualified name. -> Route parameters define a fixed value associated with a qualified name.
Rendering: selection occurs when always
126.96.36.199. Request parameters
when is the parameter is present -> when the parameter is present
when is the parameter is absent -> when the parameter is absent
a value or a pattern element a child element to match a constant or a pattern -> a value or a pattern child element to match a constant or a pattern
188.8.131.52. Route precedence
The order of route declaration is important as it influence -> The order of route declarations is important as it influences
the mapping engine processes the request path and return -> the mapping engine processes the request path and returns
Those qualified names drives -> Those qualified names drive
now language can be specified on URL. that mean user can bookmark that URL (with the information about language) or he can changed language simply by modifying the URL address -> now language can be specified in URL. That means user can bookmark that URL (with the information about language) or he can change the language simply by modifying the URL.
184.108.40.206. Portal URL
PortalURL play -> PortalURL plays
but instead subclasses -> but its subclasses instead
an URL representing -> a URL representation
PortalURL are created via to the createURL method that takes as input a resource type. A resource type is usually a constant and is a type safe object that allow to retrieve PortalURL subclasses -> PortalURL is created via to the createURL method that takes a resource type as an input. A resource type is usually a constant and is a type safe object that allows retrieval of PortalURL subclasses
Such literal were -> Such literals were
220.127.116.11. Node URL
NodeURL is one of the subclass -> NodeURL is one of the subclasses
Links included in the Portlet Bridge part should point to the current tag of PBR, i.e. in:
http://anonsvn.jboss.org/repos/portletbridge/tags/2.3.0.CP01.EPP521/examples/seam/booking/ -> http://anonsvn.jboss.org/repos/portletbridge/tags/2.3.1.GA.EPP522/examples/seam/booking/
(ResourceBean.java): http://anonsvn.jboss.org/repos/portletbridge/tags/2.3.0.CP01.EPP521/examples/richfaces/richfaces-demo/src/main/java/org/richfaces/demo/common/ResourceBean.java -> http://anonsvn.jboss.org/repos/portletbridge/tags/2.3.1.GA.EPP522/examples/richfaces/richfaces-demo/src/main/java/org/richfaces/demo/common/ResourceBean.java
Few WSRP related comments:
incorrect versions at components:
- option 1) change to general EPP_VERSION, WSRP_VERSION
- option 2) fix to 5.2.2.GA for EPP and 2.1.7-EPP522-GA for WSRP
needed by the GateIn extension mechanism
needed by the portal extension mechanism
link to community.jboss.org about JBoss WS (this is probably somewhere at access.redhat.com as well)
- "instuctions" link points to out-of-date document (it's possible to follow it, but some steps are a bit different)
- and there is nothing related to WSRP on GateIn's wiki
The recommended approach for this situation would be to use a common LDAP configuration. Please see the user guide on how to configure LDAP
- LDAP configuration is part of Ref.Guide and not User Guide, put link to 17.9
- link to AS5 documentation (WS-security) should go to access.redhat.com as well
- change version of 2.1.6-EPP522-GA to 2.1.7-EPP522-GA or to WSRP_VERSION
- change WSRP version as above (at both Notes)
Relevance: EPP 5.2 and EPP 6
Make the changes as prescribed in both versions of the document.
Some less-prescriptive observations may require some research. Ask the devs about any you are stuck on using direct email.
A release note is not required for this issue.
Ensure you have access to:
http://svn.jboss.org/repos/gatein/epp/docs/branches/5.2/ and http://svn.jboss.org/repos/gatein/epp/docs/branches/6.0/
to make changes to these guides.
After completing the changes required by this ticket, please ensure you "svn up" (or git-svn equivalent) immediately afterward.
Rendering: selection occurs when always.
Where can I find more info on the Rendering parameter?
I have fixed references to wiki where applicable. There are still some references though. If needed, please, create a new bug to import the missing information.
Fixed the "Rendering: selection occurs when always." bug based on current eXo Platform docs .
Changes in both 5.2 and 6.0 committed to respective SVN repos and staged at  and .
I recently started getting notifications on this bug about a pending (forgotten) needinfo request. IMHO there is nothing missing after ppenicka's fix so I'm clearing the flag.