[seam-issues] [JBoss JIRA] Updated: (JBSEAM-4585) Community documentation updates and improvements.

[ https://jira.jboss.org/jira/browse/JBSEAM-4585?page=com.atlassian.jira.pl... ] Lincoln Baxter III updated JBSEAM-4585: --------------------------------------- Description: 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.) ==INCOMPLETE== ** 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. *** 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. ==COMPLETED== * [Lincoln Baxter] Too hard to find JIRA links (resolved via added JIRA links to sidenav) * [Lincoln Baxter & Dan Allen] http://seamframework.org/Community/GettingStartedDevelopingTheSeamFramework -- page still references version 2.0 of Seam for new development, which is now a lie (Resolved via Seam 3 section on sfwk.org) * [Dan Allen] http://seamframework.org/Download/SeamDownloads#H-SeamSVNRepository contains repo URLs that are now broken for SCM checkout. (resolved updated links) * [Arquillian Team] Arquillian needs better getting started docs, or a clearer link to them: http://community.jboss.org/en/arquillian - This link would do: http://docs.jboss.org/arquillian/reference/1.0.0.Alpha1/en-US/html_single..., but the link may change as versions increment. Best way to handle? (resolved via http://jboss.org/arquillian) *** No clear place to get started using CDI/Weld/EE6 functionality - Persistence, Transactions, CDI, all need clear getting started information and tutorials. was: 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.) ==INCOMPLETE== ** 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. *** 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. ==COMPLETED== * [Lincoln Baxter] Too hard to find JIRA links -- added JIRA links to sidenav * [Lincoln Baxter & Dan Allen] http://seamframework.org/Community/GettingStartedDevelopingTheSeamFramework -- page still references version 2.0 of Seam for new development, which is now a lie * [Dan Allen] http://seamframework.org/Download/SeamDownloads#H-SeamSVNRepository contains repo URLs that are now broken for SCM checkout. * [Arquillian Team] Arquillian needs better getting started docs, or a clearer link to them: http://community.jboss.org/en/arquillian - This link would do: http://docs.jboss.org/arquillian/reference/1.0.0.Alpha1/en-US/html_single..., but the link may change as versions increment. Best way to handle? *** No clear place to get started using CDI/Weld/EE6 functionality - Persistence, Transactions, CDI, all need clear getting started information and tutorials. -- 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