DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG·
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://issues.apache.org/bugzilla/show_bug.cgi?id=32382>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND·
INSERTED IN THE BUG DATABASE.

http://issues.apache.org/bugzilla/show_bug.cgi?id=32382

           Summary: First App -> Example App is misleading
           Product: Tomcat 5
           Version: Nightly Build
          Platform: All
               URL: http://jakarta.apache.org/tomcat/tomcat-5.5-
                    doc/appdev/sample/
        OS/Version: All
            Status: NEW
          Severity: enhancement
          Priority: P2
         Component: Webapps:Documentation
        AssignedTo: [EMAIL PROTECTED]
        ReportedBy: [EMAIL PROTECTED]


Per discussion on the dev list (posted below) I'm attaching a WARed up version
of the example app in the "First App" tutorial and an index page with a link to 
it.
The index page should go under:
jakarta-tomcat-catalina/webapps/docs/appdev/sample

>From the dev list.....................

The "Example App" link at the end of the "First App" tutorial
http://jakarta.apache.org/tomcat/tomcat-5.5-doc/appdev/sample is a bit
misleading when viewed off the Apache site from the web.

When you click on it, it displays an Apache directory listing.
>From there, you can drill into the src directory to get
the servlet code but when you try to drill into the web directory
the index.html page gets shown and leads the viewer into thinking that
this is a working app.  It's not.  When you click on the "To a servlet"
link you see a 404 error and when you click on the "To a JSP page" link
you see the JSP code (which looks like the output from a JSP page
displayed as text because there are no JSP scriptlet tags in it).

I understand that the intent is for the viewer install TC, follow the
entire tutorial and actually deploy the examples to his/her own machine,
and then run it from there, but a casual surfer (or worse a struggling
newbie) will just see this as a non-working app with broken links.

Has anyone considered building the app, WARing it up, and putting an
index.html page at
http://jakarta.apache.org/tomcat/tomcat-5.5-doc/appdev/sample/
with a link to the war file and some basic instructions for either
running or unpacking the file to get to the src that goes with the
tutorial?

If this is a good idea, I'd be willing to build the war files and HTML
pages.

- Ben



Hi,
Go ahead, build the WAR, index page, and put it in a Bugzilla
enhancement item please.  I'd done part of this, including the WAR for
the example webapp, in the past.  I put it on my apache.org/~yoavs site,
and it was downloaded a number of times, but I accidentally deleted the
relevant directory tree a few months ago ;(

Happy thanksgiving to all,

Yoav Shapira http://www.yoavshapira.com

-- 
Configure bugmail: http://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to