Hi Once again all your comments are valuable, but a mailing list is too poor to keep track of those, please signup to add comments where needed and/or use JIRA with documentation task.
2010/11/23 Borut Bolčina <borut.bolc...@gmail.com> > Hello, > > first congratulations on a new site! > > Today I needed some information about how to test my services, so I visited > the new site and started browsing. Couldn't find the answer. Can someone > give me some pointers here? > > First I looked in the FAQ and serached for "test" withing the page with my > browser. Found 2 irrelavant hits, so I went on to the User guide. There is > a > section Test, but covers only testing of pages. > > Inspecting further to Tapestry IOC and eyeballing for something useful I > discovered a lin to registry startup, which briefly mentions what would one > want to use it: > > "However, you may want to do some integration testing using the Registry > from within a test case," > > I know there are projects out there, so you can inspect the source code to > get an example of how to test the services, but I feel it should be better > explained right on the offical page - at least in the FAQ section. It is > very hard to embrace testing to start with, so some guidance is much > appreciated. > > And the red background links must go away. > > The download section should include maven instruction, at least the > dependency section of the pom should be listed. > > There should be more room at the bottom between the last paragraph and the > footer. The header on most pages is very "white", the bottom has no space > at > all. Give it some air. > > Why is there a Book section in the Documentation with only one link to more > books? It look like an error. At least last two books (their images and > caption) should be there. > > I like the ComponentCheetSheet! A sentance or two more on each annotation > would be great. > > The tutorial Setting up your environment should be improved. Alternatives > should be described on how to run T5 apps in the Eclipse or other IDEs, but > not in the text as that would make it too long. I think there should be > links for alternative setups - like how to run the T5 app from a main class > and even start VisualVM for early debugging and optimizing (each > alternative > has pros and cons). There is no mention of m2eclipse plugin. Of course one > can use JDK 6 also - only 1.5 is there. There is a sentence: "You should > not > have to download this directly". Why are then download links on the > download > page and no mention of maven at the same time. It is confusing for newbs. > > The should also be a more visible link to T5 wiki somewhere. > > I hope I wasn't too harsh, just wanna put my perspective. > > -Borut > > > 2010/11/19 Howard Lewis Ship <hls...@gmail.com> > > > We're still working out the kinks ... and I've been working hard on > > revising > > the tutorial ... but at long last, we're debuting the new Tapestry Web > > Site: > > > > http://tapestry.apache.org/ > > > > Feedback is encouraged; just post to users@tapestry.apache.org with > [SITE] > > in the subject. > > > > -- > > Howard M. Lewis Ship > > > > Creator of Apache Tapestry > > > > The source for Tapestry training, mentoring and support. Contact me to > > learn > > how I can get you up and productive in Tapestry fast! > > > > (971) 678-5210 > > http://howardlewisship.com > > > -- Regards, Christophe Cordenier. Committer on Apache Tapestry 5 Co-creator of wooki @wookicentral.com
