[seam-issues] [JBoss JIRA] Commented: (JBSEAM-4585) Community documentation updates and improvements.
Shane Bryzak (JIRA)
jira-events at lists.jboss.org
Mon Mar 15 18:21:37 EDT 2010
[ https://jira.jboss.org/jira/browse/JBSEAM-4585?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12520023#action_12520023 ]
Shane Bryzak commented on JBSEAM-4585:
Our FAQ needs a thorough review also. Pages like http://www.seamframework.org/Documentation/IsItTrueThatSeamOnlyWorksWithJSF which state that Seam only works with JSF aren't helping us.
> Community documentation updates and improvements.
> Key: JBSEAM-4585
> URL: https://jira.jboss.org/jira/browse/JBSEAM-4585
> Project: Seam
> Issue Type: Task
> Components: Documentation Issues
> Affects Versions: The future
> Reporter: Lincoln Baxter III
> Priority: Optional
> Fix For: The future
> As part of an initiative to improve the experience for new and existing developers, community members getting involved with Seam and Weld, I am documenting a set of improvements to be made to the current state user-facing http://seamframework.org and related documentation.
> This task serves as a running list of inconsistencies, improvement areas, and erroneous information provided on SWFK.org (and related.)
> * http://seamframework.org/Community/GettingStartedDevelopingTheSeamFramework -- page still references version 2.0 of Seam for new development, which is now a lie
> * http://seamframework.org/Download/SeamDownloads#H-SeamSVNRepository contains repo URLs that are now broken for SCM checkout.
> *** No clear place to get started using CDI/Weld/EE6 functionality - Persistence, Transactions, CDI, all need clear getting started information and tutorials.
> *** No good documentation about the Seam portlet bridge, which is a closely related project. Should add visible links.
> ***It is currently impossible to subscribe for email notifications of new comments or changes on a thread unless you are the author. This is a major limitation of the seamframework.org software.
> ** Need a better knowledge base, with integrated code snippets - people need use-case driven examples, sample apps aren't enough
> ** Should provide a guided tour to "get started with seam" - this is almost a reality, but the level of knowledge required to succeed is too high.
> ** Should provide a maven archetype for seam, or provide a link to one if it exists already -- this information is currently hidden or unavailable.
> * Too hard to find JIRA links -- added JIRA links to sidenav -- Lincoln Baxter
This message is automatically generated by JIRA.
If you think it was sent incorrectly contact one of the administrators: https://jira.jboss.org/jira/secure/Administrators.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
More information about the seam-issues