The primary concern, at the moment, seems to be encouraging people to contribute documentation, tutorials and examples. Making the adding, updating and extension of docs as open (so anyone can do it) and simple (so it is not an arduous task) is the key to this. Howard's suggestion of using the confluence Wiki - and taking snapshots of docs whenever a new release is done makes sense. I would encourage anyone to contribute, and I'm sure that the regular reviewers will compensate for occasional inaccuracies. Anything more cumbersome will put people off. I don't like the idea of tying it into Maven. I for one don't use Maven, and the perceived additional complexity may put others off experimenting & using Tap.
-----Original Message----- From: Otho <taa...@googlemail.com> Reply-To: Tapestry users <users@tapestry.apache.org> To: Tapestry users <users@tapestry.apache.org> Subject: Re: Solving the T5 Documentation Dilemma Date: Fri, 1 May 2009 08:43:30 +0200 I would suggest splitting the documentation. There should be the reference documentation by the creators/commiters of the project, whis is organized like a book covering all the different aspects of tapestry 5 in a reference manner eg like spring or hibernate docs. These are tied to the release version, too. And then there should be the community docs with tutorials, howto's, recipes and so on on a wiki. There should be a pattern in the templates which requires or at least pushes you, to mention the version of Tapestry you are using. And lastly I would suggest setting up a forum. Information is more easily organized there and searching is more convenient than wíth a mailing list alone. I would think that the barrier of contributing to a forum is lower than that of contributing to / asking on a mailinglist. Well, the latter can also be seen as a feature in a way, but publicity and visibility never really hurt IMO. 2009/4/30 Piero Sartini <p...@sartini-its.com> > > I don't think Tapestry's wiki, http://wiki.apache.org/tapestry, is up > > to the task. > > Confluence is available with apache as well. There is already a space > available at http://cwiki.apache.org/TAPESTRY/ ... maybe its just a matter > of > adding content to it? > > Anyway.. on Tapestry360 someone would not need to sign a CLA to contribute > to > the documentation. > > Piero > > --------------------------------------------------------------------- > To unsubscribe, e-mail: users-unsubscr...@tapestry.apache.org > For additional commands, e-mail: users-h...@tapestry.apache.org > > --------------------------------------------------------------------- To unsubscribe, e-mail: users-unsubscr...@tapestry.apache.org For additional commands, e-mail: users-h...@tapestry.apache.org
