Re: [Wtr-general] Community involvement with Watir
2007/5/5, Željko Filipin [EMAIL PROTECTED]: On 5/5/07, Bret Pettichord [EMAIL PROTECTED] wrote: I think i convinced Zeljko today to take the lead in updating the users guide. You certainly did. Last night I had a dream how I bribed cartoon foxes from why's (poignant) guide to ruby to switch to Watir user guide. :) ( Bret encouraged me to be bold.) Zeljko, how can we all help you? The usual. Suggestions. What to add, what to remove, what to change. Comments on my changes. They will be bold. Bacon. Those foxes demanded lots of bacon. I think a section of recipes, where people could post clear and well commented code on how to do specific tasks, would also be very useful, perhaps even some non-testing stuff like automating airline ticket searching or emptying large gmail labels. It could start with finding stuff in dzone snippets and/or asking for submissions on the list/website. Cheers, Helder Zeljko -- ZeljkoFilipin.com ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general -- Then there were the lonely few of us who moved back and forth on the strip, eating rows of beads here and there, pretending we were Turing machines. -- xkcd : http://xkcd.com/c205.html ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
Re: [Wtr-general] Community involvement with Watir
Helder Ribeiro wrote: I think a section of recipes, where people could post clear and well commented code on how to do specific tasks, would also be very useful, perhaps even some non-testing stuff like automating airline ticket searching or emptying large gmail labels. It could start with finding stuff in dzone snippets and/or asking for submissions on the list/website. Just to be clear, we have always been open to having people add these to our wiki and have often encouraged this. http://wiki.openqa.org/display/WTR/Contributions Bret ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
Re: [Wtr-general] Community involvement with Watir
On 5/8/07, Bret Pettichord [EMAIL PROTECTED] wrote: I think one question Zeljko needs to address is what form he wants it to be. I think he said something about breaking it into separate files, which is fine. Another option is to migrate it to the wiki, which would make eat easier to get contributions from others... I have been thinking a lot about updating Watir user guidehttp://wtr.rubyforge.org/watir_user_guide.htmlthese days, but I did not have time to start working. I will have some time next week (if not before). I think if user guide is migrated to Watir Wikihttp://wiki.openqa.org/display/WTR/Project+Homeit would make contributions much easier, so I plan to do that. If anybody would like to start working on user guide before I migrate it to Wiki, go ahead and grab it from Watir SVN http://svn.openqa.org/svn/watirrepository, make Wiki page and start working. If you do not know how to get it from SVN repository http://www.openqa.org/watir/cvs.action or how to create Wiki pagehttp://wiki.openqa.org/display/WTR/Contributing+to+this+Website, please let me know. I received a lot of good advice about updating user guide. There is a clear need for more documentation on Watir. I do not think that everything should be in user guide. My plan is to make user guide as short as possible and provide links to more advanced topics. Something like: - Install Ruby. - Install Watir. - Open IE. - Navigate to a page. - Click a link. - Click a button. - Verify some text is there. - That was easy! - Want to learn more? - See how you can work with: - Other tags. - Various pop-up windows. - JavaScript. - AJAX. - Unit tests (running them, reading them, learning from them). - … - There is also lots of good documentation on Watir that *is* at our site. See: - FAQ - What is Ruby? - What is Watir? - Is there a difference? - Why should I care? - … - There is also lots of good documentation on Watir that *is not* at our site. Check it out: - Articles. - Cheat sheets. - Books. - … - Have question? We have mailing list! When posting a question make sure that you include: - Relevant snippet of your Watir code. - Relevant snippet your HTML. - Error message that Ruby gave you (if any). - See example question. I think this short tips about posting to mailing list are very important. I just hope people will read it. I think we are ready for several Watir tutorials (at least two). Take Ruby for example. It has Pickaxehttp://www.pragmaticprogrammer.com/titles/ruby/index.htmlbook that you can have on your desk and not be embarrassed when you boss takes a look at it. There is also Why's (Poignant) Guide to Rubyhttp://poignantguide.net/ruby/. I remember how my boss was surprised when he saw Why's book. I am sure he thought I was joking when I told him that it is a book about programming. (Hint: cartoon foxes shouting Chunky bacon!.) Watir user guide can have enterprise look, but I would also like to create one version with cartoon characters. I am sure there are lots of creative people here and I hope they will show their creativity. If you would not like to see cartoon characters in Watir user guide, please do let me know, I will not put it at Watir Wiki. (I will put it at my blog and smile to my jokes. Alone.) Zeljko -- ZeljkoFilipin.com ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
Re: [Wtr-general] Community involvement with Watir
Željko Filipin wrote: Watir user guide can have enterprise look, but I would also like to create one version with cartoon characters. I am sure there are lots of creative people here and I hope they will show their creativity. If you would not like to see cartoon characters in Watir user guide, please do let me know, I will not put it at Watir Wiki. (I will put it at my blog and smile to my jokes. Alone.) Chunky Bacon! ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
Re: [Wtr-general] Community involvement with Watir
I'm all for a Why style guide. His surreal style sucks more people in than if it was a plain old manual. Maybe a donut eating platypus instead of foxes. :) -c On 5/9/07, Bret Pettichord [EMAIL PROTECTED] wrote: Željko Filipin wrote: Watir user guide can have enterprise look, but I would also like to create one version with cartoon characters. I am sure there are lots of creative people here and I hope they will show their creativity. If you would not like to see cartoon characters in Watir user guide, please do let me know, I will not put it at Watir Wiki. (I will put it at my blog and smile to my jokes. Alone.) Chunky Bacon! ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
Re: [Wtr-general] Community involvement with Watir
On 09/05/07, Bret Pettichord [EMAIL PROTECTED] wrote: Just to be clear, we have always been open to having people add these to our wiki and have often encouraged this. http://wiki.openqa.org/display/WTR/Contributions Bret I think all these important links should become a footnote on Watir's main page. A page that could link to every major contribution, Watir assets have become too amorphous. Also additional user-guide sugesstions IDE's: Arachno, Eclipse, Emacs Test Frameworks: Data-driven, test DSL's?, object mapping, Test::Unit Test Reports: I have written some XML + XLST = HTML. I will put it on the FAQ's. Aidy ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
Re: [Wtr-general] Community involvement with Watir
Christopher Rasch wrote: Thanks! How should we contribute to the User Guide? It doesn't appear to be user editable: http://wtr.rubyforge.org/watir_user_guide.html This HTML file is stored in our SVN repository. I think one question Zeljko needs to address is what form he wants it to be. I think he said something about breaking it into separate files, which is fine. Another option is to migrate it to the wiki, which would make eat easier to get contributions from others... Is this the wiki we should be editing? http://wiki.openqa.org/display/WTR/Project+Home Feel free to add my tutorial for installing FireWatir on Mac OS X (Intel) (or let me know where I should add it): http://crasch.livejournal.com/550521.html#cutid1 Yes this is our wiki. Anybody can edit the wiki. If you see something that could be improved please just go ahead and make the change. If you have bold changes you are considering, but would like review first, you can always create a new page with the changes and then solicit review. Under what license do you publish the Watir documention? I suppose it is covered by the same BSD license that covers the code. Why do you ask? Do you have suggestions or concerns? Bret ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
Re: [Wtr-general] Community involvement with Watir
Bret Pettichord wrote: Christopher Rasch wrote: Thanks! How should we contribute to the User Guide? It doesn't appear to be user editable: http://wtr.rubyforge.org/watir_user_guide.html This HTML file is stored in our SVN repository. I think one question Zeljko needs to address is what form he wants it to be. I think he said something about breaking it into separate files, which is fine. Another option is to migrate it to the wiki, which would make eat easier to get contributions from others... Okay, thanks! My vote would be to put it in the Wiki. Yes this is our wiki. Anybody can edit the wiki. If you see something that could be improved please just go ahead and make the change. If you have bold changes you are considering, but would like review first, you can always create a new page with the changes and then solicit review. Thanks! Under what license do you publish the Watir documention? I suppose it is covered by the same BSD license that covers the code. Why do you ask? Do you have suggestions or concerns? I want to put a notice that anyone can use the documentation that I write on my blog, and I wanted to make sure that the license I chose was compatible with the license for Watir's documentation. Chris ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
Re: [Wtr-general] Community involvement with Watir
Charley Baker wrote: Hi all, I'd like to send out another annoucement asking for people to contribute to the Watir user guide and volunteer. I've started poking around at the user guide today and made a few changes, notably to update view source with the ie developer toolbar. I'll make further changes if as I get time, but am making the call for volunteers to add information and help out, much of which is related to Watir 1.5. Let me know if you're interested in helping out. Hi Charley, Thanks! How should we contribute to the User Guide? It doesn't appear to be user editable: http://wtr.rubyforge.org/watir_user_guide.html Is this the wiki we should be editing? http://wiki.openqa.org/display/WTR/Project+Home Feel free to add my tutorial for installing FireWatir on Mac OS X (Intel) (or let me know where I should add it): http://crasch.livejournal.com/550521.html#cutid1 Under what license do you publish the Watir documention? Chris ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
Re: [Wtr-general] Community involvement with Watir
Thanks! How should we contribute to the User Guide? It doesn't appear to be user editable: I'd suggest either adding to this thread, or contacting Zeljko directly. Feel free to add my tutorial for installing FireWatir on Mac OS X (Intel) (or let me know where I should add it): http://crasch.livejournal.com/550521.html#cutid1 I couldn't get the Linux jssh xpi to function with the lastest osx and latest FF. In another thread (and mentioned to Angrez) I found a Darwin jssh that worked properly. ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
Re: [Wtr-general] Community involvement with Watir
Chris McMahon wrote: Thanks! How should we contribute to the User Guide? It doesn't appear to be user editable: I'd suggest either adding to this thread, or contacting Zeljko directly. Thanks! Feel free to add my tutorial for installing FireWatir on Mac OS X (Intel) (or let me know where I should add it): http://crasch.livejournal.com/550521.html#cutid1 I couldn't get the Linux jssh xpi to function with the lastest osx and latest FF. In another thread (and mentioned to Angrez) I found a Darwin jssh that worked properly. Hmm...the only message I could find was this one, which suggest that the Linux jssh xpi worked. On 5/3/07, Angrez Singh [EMAIL PROTECTED] wrote: Hi Chris, Did you tried the XPI at http://alephzarro.com/blog/2007/03/12/jssh-for-firefox-on-linux-because-firewatir-loves-it Its an XPI for linux but seems to work on Mac OS also (according the link i sent you in last mail) Yay! That one works. Interestingly, it has the same name as the one from mozilla, but it behaves differently. -Chris ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
Re: [Wtr-general] Community involvement with Watir
On 5/5/07, Bret Pettichord [EMAIL PROTECTED] wrote: I think i convinced Zeljko today to take the lead in updating the users guide. You certainly did. Last night I had a dream how I bribed cartoon foxes from why's (poignant) guide to ruby to switch to Watir user guide. :) (Bret encouraged me to be bold.) Zeljko, how can we all help you? The usual. Suggestions. What to add, what to remove, what to change. Comments on my changes. They will be bold. Bacon. Those foxes demanded lots of bacon. Zeljko -- ZeljkoFilipin.com ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
Re: [Wtr-general] Community involvement with Watir
Zeljko, how can we all help you? The usual. Suggestions. What to add, what to remove, what to change. Comments on my changes. They will be bold. Bacon. Those foxes demanded lots of bacon. Chunky bacon! One thing I would like to see featured prominently is a discussion not only of how to run the unit tests, but also how to read the unit tests. Also, a discussion of how to surf watir.rb itself for particular methods like show_whatever and even how goto() works would be useful. Both the unit tests and watir.rb are pretty literate, and not too difficult to parse, even for less-experienced Rubyists. ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
Re: [Wtr-general] Community involvement with Watir
Charley Baker wrote: I'd like to send out another annoucement asking for people to contribute to the Watir user guide and volunteer. I've started poking around at the user guide today and made a few changes, notably to update view source with the ie developer toolbar. I'll make further changes if as I get time, but am making the call for volunteers to add information and help out, much of which is related to Watir 1.5. Let me know if you're interested in helping out. I think i convinced Zeljko today to take the lead in updating the users guide. Zeljko, how can we all help you? Bret ___ Wtr-general mailing list Wtr-general@rubyforge.org http://rubyforge.org/mailman/listinfo/wtr-general
