Hi, I completely agree with Kalle on:
"but I bet that users in general are missing documentation that is more flowing and more tutorial type, similar to Spring's and Hibernate's. It's difficult to use the current documentation if you don't know exactly what you are looking for." I would also say that the actual website looks like a bit "older" and would need some redesign, with quotes from users, community sections etc. Like : http://liftweb.net/ http://www.grails.org/ http://jquery.com/ Regards, Robin On Fri, Apr 30, 2010 at 3:06 AM, Kalle Korhonen <[email protected]>wrote: > It's a bit more than just the organization of the documentation IMHO. > The existing documentation is of really good quality, but I bet that > users in general are missing documentation that is more flowing and > more tutorial type, similar to Spring's and Hibernate's. It's > difficult to use the current documentation if you don't know exactly > what you are looking for. Wiki is a better format for the tutorials > since there's so much to improve on the linguistic form alone. > Tynamo.org is of course a much smaller project than Tapestry, but > hopefully we've at least proven that Wiki is a viable format for > "official" documentation. Another thing we've been able to do thanks > to Codehaus, is a seamless integration of Wiki and Maven-based content > (for example, compare http://tynamo.org/Overview and > http://tynamo.org/tapestry-model/tapestry-model-core/dependencies.html > - the former is a pure wiki page and the latter is Maven originated > content). It's a pity that Maven doesn't currently have better > out-of-box support for integrating with Wiki systems. > > I think the lack of comments doesn't imply lack of interest, but the > fact that its difficult to suggest a good, compromising solution. > Hopefully I didn't muddy the waters too much with this post but in > general, I'm in favor of making (parts of) the documentation > wiki-based. > > Kalle > > > On Thu, Apr 29, 2010 at 3:13 PM, Igor Drobiazko > <[email protected]> wrote: > > Well, I'm pretty fine with Maven-based site. There is no lack of > > documentation. The problem is the structure and organization. Tapestry's > > documentation is hard to find because it is spread over several modules. > > First of all we need to move T5 site to the start page and maybe put all > the > > documentation into a single module. I guess no switch to any technology > or > > format is needed. > > > > On Thu, Apr 29, 2010 at 9:36 PM, Sebastian Hennebrueder > > <[email protected]>wrote: > > > >> Hi all, > >> > >> I would like to know, if there is still interest in a website update or > >> not. We have seen so many discussion threads on the topic but every time > >> there is something concrete there is a long silence. > >> > >> I made some efforts to create a new website structure using existing > >> technologies (Maven site). There had been some remarks on that but the > >> effort got stuck finally. Some community members proposed to look for a > >> better more flexible technology in order to integrate news or other > sources > >> of information. > >> > >> In a recent discussion Ulrich proposed the alternative to use a Wiki > based > >> solution and I proposed the use of a static site generator. We discussed > >> pros and cons but did not get to a final decision. Both approaches are > >> viable solutions. > >> > >> About 10 days ago, I put together a prototype to demonstrate how a > static > >> site generator works and allow the community to play with that solution. > I > >> was a kind of surprised that there wasn't a discussion. It is fine, if > we > >> decide not to use the approach because this allows us to go with the > Wiki > >> approach or another alternative. But if there is no interest in > discussing > >> and finally deciding on alternatives, then it is most unlikely that we > will > >> ever manage to update the website. > >> > >> -- > >> Best Regards / Viele Grüße > >> > >> Sebastian Hennebrueder > >> ----- > >> Software Developer and Trainer for Hibernate / Java Persistence > >> http://www.laliluna.de > >> > >> > >> > >> > >> --------------------------------------------------------------------- > >> To unsubscribe, e-mail: [email protected] > >> For additional commands, e-mail: [email protected] > >> > >> > > > > > > -- > > Best regards, > > > > Igor Drobiazko > > http://tapestry5.de/blog > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > >
