watir/watir-webdriver — pull request #164 by p0deje (2012-09-19 07:33:53+00:00)
Title: Documentation improvements

I've added a lot of comments for methods with examples, params, returns, etc.

I don't want to push it directly as long as it may have bad english or incorrect examples (while I tried to make sure they are correct). So, please, take a look. I know it's huge but still ;)

Also, I've removed `row_container.rb` and `cell_container.rb` and moved them to elements making them global. I did this to make the approach a bit more consistent. It's committed with all the docs, but I can revert it manually if you think it's a bad idea.

Also, [Ruby Style Guide](https://github.com/bbatsov/ruby-style-guide) recommends not to leave empty line between method comment and definition. I didn't follow it because other comments have empty line, but I'll remove them if no one objects.