Željko Filipin's blog.
Home Blog Tags Now License

View on GitHub
9 May 2007

Updating Watir User Guide (2)

by Željko Filipin

(From wtr-general.)

I have been thinking a lot about updating Watir user guide these 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 Wiki it 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 repository, make Wiki page and start working. If you do not know how to get it from SVN repository or how to create Wiki page, 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:

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 Pickaxe book 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 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.)

tags: TODO