search

watir / watir.github.io

Code for our Website
http://watir.github.io/
MIT License
11 stars 65 forks source link

Added a quickstart guide #148

Closed lucienbill closed 5 years ago

lucienbill commented 6 years ago

I found a very useful guide that really helped me getting started with Watir. I would like to see it referenced to in the official documentation, so I forked the website and modified it. Here is the pull request : feel free to do whatever you wish to do with it ;)

titusfortner commented 5 years ago

Yes, we had this as a guest blog article last year: http://watir.com/browser-automation-with-watir-guide-for-testers/

I'm not going to add this PR for a handful of reasons:

  1. I don't want to reference 3rd party sites directly from the Guides section. Perhaps we can update this page with more direct info: http://watir.com/blog-list/
  2. I do not agree with some of the author's opinions on how to approach UI tests
  3. There are a few technical inaccuracies in the code; a few things that are now deprecated
  4. Almost all of the information there is present in our guides already, so I'm curious if you (@lucienbill) found it too disjointed, and/or if we need a better presentation of the information we have?
  5. I do think we should have a slightly more "real world" tutorial, but I'd like for the project to write that directly (a la #6) Granted I was hoping we'd have resolved a number of these issues more rapidly than we have, but for some of us it is significantly more fun to be in the code. :)
lucienbill commented 5 years ago

Thanks for the answer! Here are mines:

  1. That's a valid reason to reject the request; Adding the link to the blog-list is a good idea! I might create a pull request some day for this update, but first I'd have to read the page and make sure my contribution would be relevant.
  2. Good reason to close as well. I sense the potential for a very interesting discussion about UI testing, but this PR might not be the right place for that.
  3. :+1:
  4. The only issue I had with Watir's documentation was the lack of an example script. I just needed to see a functioning example to understand how to start my code. Once I read Maciej Stanisz's guide, I figured out how to run my very first "hello world" in Watir, and everything became very easy. Is used Watir's official documentation for the actual logic of my code and had no difficulty understanding it.
  5. We live in a world of finite time and resources: I'd rather have a really nice tool that lacks some documentation, than having it the other way around. Once I get a bit more experienced with Watir (and Ruby), I might try to write a "hello world" guide : just a simple script that opens a browser and navigates into a specific URL. I hope to find some time for this in the next 3 months!

EDIT 2018/12/06:

My real issue is that I apparently can't read! A simple code example is right on the frontpage of your documentation! How the hell did I manage to miss it? On the positive side: it is just my "chair-keyboard" interface that needs fixing, your documentation is fine.

titusfortner commented 5 years ago

@lucienbill - I've added a full example for filling out a form on a real website: http://watir.com/guides/form-example/

Let me know if this better addresses your concerns. Perhaps this more complete example is located in a more obvious place?

lucienbill commented 5 years ago

It is perfect!