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]
