[ https://issues.apache.org/jira/browse/TAP5-1753?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Bob Harner updated TAP5-1753: ----------------------------- Priority: Major (was: Blocker) Assignee: Bob Harner (was: Howard M. Lewis Ship) "Blocker" means development progress (on Tapestry) cannot continue. This is a major issue, but not a blocker. > Several Problems/BUGs on Tapestry 5 Tutorial > -------------------------------------------- > > Key: TAP5-1753 > URL: https://issues.apache.org/jira/browse/TAP5-1753 > Project: Tapestry 5 > Issue Type: Bug > Components: documentation > Reporter: Axel Werner > Assignee: Bob Harner > Labels: beginners, tutorial > > Hi there, > im recently trying to learn tapestry5 from the ground up using the tutorial > provided at > http://tapestry.apache.org/using-beaneditform-to-create-user-forms.html . > There i figgured (at least for me) some major Problems or Missing parts in > the Tutorial that do pretty much BLOCK me from continuing since i cannot > follow the tutorial from a certain point. I also added other suggestions to > improve the tutorial or to point you devs onto the missing point. the order > of the following ordered list is NOT IMPORTANT. > 1. > basic projects starting using manualy installed maven and command line > interface. cool thing! but whats next? Do i have to start any new tapestry > project using the maven on command line now and import the thing into eclipse > ?? what about "how to start a basic tapestry5 project from within eclipse?" > ?? This point is completly missing in the tutorial. just a suggestion/feature > request for the tutorial. > 2. > major problem here/BLOCKER: > A tutorial should be linear/continuisly. so that one point leads into the > other, without breaks or missing stuff. I found a place where i miss at least > several realy important things that BLOCKS me yet from continuing the > tutorial. > That is > http://tapestry.apache.org/using-beaneditform-to-create-user-forms.html , > especialy the section about "adding validation". > If you play through the tutorial step by step like i did, you will get lost > here! > Some paragraph says: "Update the getter methods for the lastName,..." - but > WHERE?? No mention anywhere. You know it? Good! I dont, and i got lost here. > I "assumed" it may go into the address.java (struct style) class, but if you > do it, it will FAIL, since there are other important things to know or to do > first which are also NOT MENTIONED in the tutorial at this point. NEEDS > ATTENTION. > 3. > There seem to be even more ERRORS/MISTAKES in this tutorial. At > http://tapestry.apache.org/using-tapestry-with-hibernate.html , there is > mentioned a file > src/main/java/org/apache/tapestry5/tutorial/entities/Address.java > which just DOES NOT MATCH the package path that is used in this tapestry5 > tutorial! This may look easy to you, but for someone new like me which is all > new to the whole java world will have trouble fixing this error. > The correct tutorial packet path should be: > src/main/java/com/example/tutorial1/entities/address.java i guess. > PLease re-check by following the whole tutorial step by step, and you will > run into these errors/blockings. > Some apreciation: till here the tutorial is quite good and i love it! pls > keep up the good work, complete/fix the tutorial and maybe even add some > additional chapters. > Hopefully my report/suggestion will find its way to the author/maker of the > tutorial. > Thanks n c u > Axel Werner > m...@awerner.homeip.net -- This message is automatically generated by JIRA. If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa For more information on JIRA, see: http://www.atlassian.com/software/jira