[
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==
*
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.
==COMPLETED==
* Too hard to find JIRA links -- added JIRA links to sidenav -- Lincoln Baxter
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==
*
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.
==COMPLETED==
* Too hard to find JIRA links -- added JIRA links to sidenav -- Lincoln Baxter
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.)
==INCOMPLETE==
*
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.
==COMPLETED==
* 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