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

[Geoffrey De Smet (JIRA)]

    [ https://jira.jboss.org/jira/browse/JBSEAM-4585?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12519276#action_12519276 ] 

Geoffrey De Smet commented on JBSEAM-4585:
------------------------------------------

"I really don't understand why we have to present both HTML and HTML single either"

I personally always use the HTML single, and I believe that should be available directly on the docs page. Here's why:
Control-f to find something about - let's say "maven" or "i18n" -, which doesn't work in the non single page HTML.

Nevertheless this is a great initiative, and I think a common "mimimal" convention should be proposed and discussed, which could be followed in other projects (including Drools where I am involved).
Have you thought about a hudson link?

> 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.
> ***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

-- 
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