I disagree with moving stuff from the website to the wiki. I think the component doc should go on the website and be part of the official MyFaces svn. This will also ensure uniform standards and quality of the doc.
If users want to put extra component doc in the wiki (or are not comfortable with Forrest or subversion) then as Martin said, this will be a small help b/c eventually we can move it. IMO wiki is also a good candidate for server configuration, IDE configuration, etc. Additional examples are also fine for wiki. But documentation on the components should be on the website. That's what is expected. Check out the Ant project. You will see all of the tasks documented right there (no wiki.) sean On 8/25/05, ir. ing. Jan Dockx <[EMAIL PROTECTED]> wrote: > Well, -1 on that, actually. I am a great believer in wiki's, and I > suggest that you won't copy the doc to the homepage, but link from the > homepage to the wiki. One of the stifling things about the MyFaces > documentation is that it is in Too Many Places. Nobody knows where to > look exactly, people are not eager to work on doc's that are not the > reals doc's, and create patches and submit them and stuff is far to > time consuming. For writing doc's in the wiki, you don't need to > checkout the source tree. This is enduser documentation, not developer > documentation, so the overhead is stifling the work. > > I suggest "we" decide that the documentation will be the wiki. Let's > move whatever there is in /forest/content to the wiki (users can do > that), and kill that part it Subversion. The examples should stay. At a > (much) later date, somebody could decide to create a pdf or a book > based on the wiki, but that's another story, and not our current > concern. > > > On 25 Aug 2005, at 16:29, Martin Marinschek wrote: > > > +1 > > > > ;) > > > > If you want to get involved even more, it would be great if you would > > add this documentation to the /forrest/content section of our > > sourcetree for viewing it on the homepage. > > > > (just send us patches, we will commit them) > > > > If not, just put it on the WIKI, and gradually we will move it over to > > the homepage. > > > > regards, > > > > Martin > > > > On 8/25/05, Clément Maignien <[EMAIL PROTECTED]> wrote: > >> > >> +1 > >> > >> > >> -----Message d'origine----- > >> De : ir. ing. Jan Dockx [mailto:[EMAIL PROTECTED] > >> Envoyé : jeudi 25 août 2005 16:16 > >> À : MyFaces Discussion > >> Objet : Let's write that doc! > >> > >> I suggest that we make this a user effort. Everybody, make an account > >> in the > >> wiki, and <a > >> href="http://wiki.apache.org/myfaces/MyFacesComponents";>let's > >> start documenting those components</a>. If everybody writes a little > >> piece > >> (what is it for, how to use it), we'll have full documentation by > >> Monday. > >> > >> I just added a little grain. More to come, I promise. > >> > >> > >> On 25 Aug 2005, at 15:30, Sean Schofield wrote: > >> > >> > >> > >> Thanks so much for pointing out that messages tag. I was just about > >> to write something similar because I didn't know about it. Is it > >> listed somewhere on the MyFaces website? I don't see it here: > >> http://myfaces.apache.org/tomahawk/overview.html > >> > >> Unfortunately that page is woefully out of date. Updating it is on my > >> shortlist of things to do. > >> > >> > >> Regarding your comment on it being specific to MyFaces: Isn't it only > >> specific to the MyFaces extensions? In other words, couldn't I use it > >> with the RI as long as I included the myfaces-extensions-1.0.9.jar and > >> referenced the taglib? > >> > >> Right you can use tomahawk with the RI and if you want that > >> functionality use <t:message> instead of <h:message>. > >> > >> > >> -Ken > >> > >> sean > >> > >> > >> Met vriendelijke groeten, > >> > >> Jan Dockx > >> > >> PeopleWare NV - Head Office > >> Cdt.Weynsstraat 85 > >> B-2660 Hoboken > >> Tel: +32 3 448.33.38 > >> Fax: +32 3 448.32.66 > >> > >> PeopleWare NV - Branch Office Geel > >> Kleinhoefstraat 5 > >> B-2440 Geel > >> Tel: +32 14 57.00.90 > >> Fax: +32 14 58.13.25 > >> > >> http://www.peopleware.be/ > >> http://www.mobileware.be/ > >> > > > > > > -- > > > > http://www.irian.at > > Your JSF powerhouse - > > JSF Trainings in English and German > > > > > Met vriendelijke groeten, > > Jan Dockx > > PeopleWare NV - Head Office > Cdt.Weynsstraat 85 > B-2660 Hoboken > Tel: +32 3 448.33.38 > Fax: +32 3 448.32.66 > > PeopleWare NV - Branch Office Geel > Kleinhoefstraat 5 > B-2440 Geel > Tel: +32 14 57.00.90 > Fax: +32 14 58.13.25 > > http://www.peopleware.be/ > http://www.mobileware.be/ > > >
