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

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 Fix For: 2.0.0.GA 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.