0 Replies Latest reply on Aug 7, 2006 4:09 AM by theute

    Decent documentation complain

    theute

      I just received this from forward of forward emails:

      hi - i am a developer and i think you guys will help yourself a lot if you can come up with decent documentation. specifically, i spent almost a week on seam and i am still next to nowhere. first i spend a lot of time finding the right version of jboss as to deploy it. 4.0.4 ga does not run it unless you find the "special" installer that is in beta. second, constantly deploying it from eclipse just drives me crazy. it should be autodeployed from directly from workspace, as the article at http://wiki.jboss.org/wiki/Wiki.jsp?page=EclipseSeamAutoDeploy
      suggests, and does not work. also, it is said that seam can be used with tomcat, outside jboss. that would be great for faster development, but where is an example. it is shame probably on my part for not having weeks to figure things out, but after a week of literally wasting time with it, and now it is 3:40 am as i am writing these lines, i have to tell you, please, ready some professional grade documentation with versions of things that work together, preferably with links to their downloads, because it is *frustrating* to see a possibly great tool (seam) out there but burn way too much time, a week now, to get it working inside eclipse. thanks. --a



      Let me answer point by point on the common way of discussion.
      first i spend a lot of time finding the right version of jboss as to deploy it. 4.0.4 ga does not run it unless you find the "special" installer that is in beta.

      This is mentionned (with direct link to the download) :
      * Here: http://labs.jboss.com/portal/jbossseam/gettingstarted/index.html
      * Here: http://wiki.jboss.org/wiki/Wiki.jsp?page=SeamInstallation
      * In the readme.txt file of the package
      * in many places on the forum
      constantly deploying it from eclipse just drives me crazy. it should be autodeployed from directly from workspace, as the article at http://wiki.jboss.org/wiki/Wiki.jsp?page=EclipseSeamAutoDeploy
      suggests, and does not work.

      This has few or nothing to do with documentation, the wiki page is correctly stating the current steps to workaround a known limitation of Eclipse (unable to deal with embedded projects). The Wiki area remains a place for contributors updated and fixed on their own will.
      By the way we are working on a Eclipse plugin to let you modify your JSF pages without having to redeploy.
      it is said that seam can be used with tomcat, outside jboss. that would be great for faster development, but where is an example

      Most of the examples can run in Tomcat, there are targets and it is explained in the section called: "How to Build and Deploy the Example on Tomcat" of the readme.txt file of the examples, basically you just need to do "ant deploy.tomcat"

      I am ready to listen to documentation complains, but please take the time to read the readme.txt files.