[jira] [Commented] (TAP5-1753) Several Problems/BUGs on Tapestry 5 Tutorial

["Axel Werner (Commented) (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/TAP5-1753?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13155763#comment-13155763 ] 

Axel Werner commented on TAP5-1753:
-----------------------------------

"however it does sound like you arrived at a page in the middle of the tutorial and ignored the navigation (top and bottom of each page) that would let you start from the beginning of the tutorial. "

NEGATORY! dont wipe it away that easy. whenever "available" i follow the navigation links in a tutorial. 

1st
I arrived at the first page (http://tapestry.apache.org/tapestry-tutorial.html) and started from here. AND AS YOU CAN SEE there are NO NAVIGATION elements there (just for example). So not "each page" does have those. However at the end of the page it has a link to "another" page that seems to be the next in order. so i click that. 

2nd
Whenever possible i use (of course!) the navigation links (preview/next, BTW: they are not called "prev./next") to nagivate through the tutorial. but that is not the problem here. the problems are mistakes/errors/missing things inside of the tutorial. if you follow the tutorial step by step just stupidly with a beginners knowledge you WILL stumble on the problems too. there is no doubt. since you said you changed something, i am going to re-view the whole tutorial , recheck those places and let you know here in this ticket. 

3.
For me it seems you didnt realy re-checked/re-played the tutorial step by step yet. then why is it still "not tested with Maven 3.0+" ?? See "Tutorial Page 2" http://tapestry.apache.org/dependencies-tools-and-plugins.html at maven chapter. No one realy would/will test it with some old version of some tool/package. at least not newbies.

will report "more findings" later after done more replaying. 
since here this case seems not to be done yet.

regards
Axel
                
> 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: Howard M. Lewis Ship
>            Priority: Blocker
>              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
> mail@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