Re: RE : Let's write that doc!

2005-08-26 Thread Martin Marinschek
You know what? There is nothing like official information. If you start off doing the doc on the wiki, and it gets better than the one on the webpage (and trust me, I will add a link to the corresponding wiki pages from the component pages to ensure competitition is fair); your doc will grow to

Re: RE : Let's write that doc!

2005-08-26 Thread Craig McClanahan
On 8/25/05, ir. ing. Jan Dockx [EMAIL PROTECTED] wrote: Trust me, I love the work you're doing. And I don't want to make enemies. I'm standing on the sidelines on this particular issue, but it is worth making a point here ... people who end up making major contributions to the open source

Re: RE : Let's write that doc!

2005-08-26 Thread Martin Marinschek
Yes, get us the beef ;) You can change something if you are motivated (and motivate others), that's for sure! regards, Martin On 8/26/05, Craig McClanahan [EMAIL PROTECTED] wrote: On 8/25/05, ir. ing. Jan Dockx [EMAIL PROTECTED] wrote: Trust me, I love the work you're doing. And I don't

RE : Let's write that doc!

2005-08-25 Thread Clément Maignien
Title: Message +1 -Message d'origine-De: ir. ing. Jan Dockx [mailto:[EMAIL PROTECTED] Envoyé: jeudi 25 août 2005 16:16À: MyFaces DiscussionObjet: Let's write that doc!I suggest that we make this a user effort. Everybody, make an account in the wiki, and a

Re: RE : Let's write that doc!

2005-08-25 Thread Martin Marinschek
+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

RE: Let's write that doc!

2005-08-25 Thread Delbrouck, Henri-Philippe
Title: Message Very Good suggestion. I already intend to put example and doc for the JSCookMenu. If everyone who gains experience with some specific component could put example and how to use the component in the wiki, this will reduce mails and questions when we start working with a new

RE : Let's write that doc!

2005-08-25 Thread ir. ing. Jan Dockx
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

Re: RE : Let's write that doc!

2005-08-25 Thread Sean Schofield
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

Re: RE : Let's write that doc!

2005-08-25 Thread Martin Marinschek
I totally agree with Sean. Wikis are great for additional info! I like the idea though to link from the homepage component page to the wiki page, to find that link faster. regards, Martin On 8/25/05, Sean Schofield [EMAIL PROTECTED] wrote: I disagree with moving stuff from the website to the

Re: RE : Let's write that doc!

2005-08-25 Thread ir. ing. Jan Dockx
You obviously have a lot of time at your disposal ;-). But hey, it's you project. I was writing some doc's on the wiki right now, but I am not going to go through the hassle of creating patches and stuff. You obviously want tight control, and you're welcome to that, of course. Sadly, that means no

Re: RE : Let's write that doc!

2005-08-25 Thread Mike Kienenberger
No one is saying that you shouldn't write the docs on the wiki. They're just saying that the official version of the documentation is in svn, and that documentation in the wiki eventually needs to be ported over to the website, and that submitting a patch to do so make the process go faster. In

Re: RE : Let's write that doc!

2005-08-25 Thread ir. ing. Jan Dockx
I'm not saying *I* am not writing doc's on the wiki. I am saying that with these rules, there won't be a giant, inspired, communal effort to create the docs. I *am* saying that I will not be submitting patches for documentation, and that I suspect nobody will, because of the large effort this

Re: RE : Let's write that doc!

2005-08-25 Thread Sean Schofield
No one is saying that you shouldn't write the docs on the wiki. They're just saying that the official version of the documentation is in svn, and that documentation in the wiki eventually needs to be ported over to the website, and that submitting a patch to do so make the process go faster.

Re: RE : Let's write that doc!

2005-08-25 Thread Sean Schofield
It's not too hard to write forrest documentation. It takes a little bit of effort and if you or any other user does not want to put forth that effort then fine. As for your lack of interest in creating svn patches ... well that is how things are done at the ASF. The project is not a giant

Re: RE : Let's write that doc!

2005-08-25 Thread ir. ing. Jan Dockx
Trust me, I love the work you're doing. And I don't want to make enemies. Sadly, the response you sent confirms my analysis: you are very, very busy after hours making great code for MyFaces, and you have no time to spent on the documentation 'right now'. That next version needs shipping. You're