[jbossseam-issues] [JBoss JIRA] Created: (JBSEAM-1999) Improve documentation of when the ConversationList component is populated

Fri Sep 28 14:54:40 EDT 2007

Improve documentation of when the ConversationList component is populated
-------------------------------------------------------------------------

                 Key: JBSEAM-1999
                 URL: http://jira.jboss.com/jira/browse/JBSEAM-1999
             Project: JBoss Seam
          Issue Type: Task
    Affects Versions: 2.0.0.CR1
            Reporter: Jacob Orshalick
            Priority: Minor

The conversationList is only populated with a ConversationEntry if entry.isDisplayable() returns true (which requires a description entry in pages.xml).  6.7.1 and 6.7.2 show how to set the descriptions for pages in the pages.xml to populate the ConversationList, but neither sections 6.7.1, 6.7.2, 6.7.3, or 28.4 describe this behavior.  Having this described in the documentation would likely help new users.

In addition, a nice-to-have would be a warning in the log or some default description if the conversationList is requested and a ConversationEntry is not displayable.

The documentation could state something like:

The conversationList component will only be populated with a ConversationEntry if a description of the conversation's view-id is provided in pages.xml.  Adding descriptions to a view-id in pages.xml is described in Sections 6.7.1 and 6.7.2.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.jboss.com/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira