Jeff Fry wrote:
On 5/15/07, *Bret Pettichord* <[EMAIL PROTECTED]
<mailto:[EMAIL PROTECTED]>> wrote:
Jeff Fry:
>
> * Think about how best to lay out hows & whats. Please comment.
>
Unless someone volunteers manually keep all the duplication in sync
(Maybe you are volunteering to do this -- it's not clear to me),
then I
plan to consolidate it so that it is at least accurate. Right now,
it is
easy to read (somewhat) but incomplete, which is pretty bad.
I think consolidating it is the right choice. If it would be helpful,
I'll try to take a first whack at this by the beginning of next week
as well. I'm sure whatever I make will/would contain inaccuracies (
e.g. my not knowing that the multiple attribute support only for
non-input elements) but if my creating a first draft would help I will
see what I can put together between tonight and this coming Wednesday.
Here's my first stab at a centralized page to describe supported
elements, 'how's for interacting with those elements, and a chart of
which 'how's apply to which elements:
http://wiki.openqa.org/display/WTR/Methods+supported+by+Element
For the chart, I tried to follow the rdoc, but I didn't follow it too
closely, knowing that the rdoc already has inaccuracies in it. I'm
hoping that someone who knows what *actually* does and doesn't work will
volunteer to correct the chart (or even just email me corrections to
make myself).
I added a number of questions at the bottom of the page, but will repeat
them here for convenience:
* Are there any missing element types, or element types that shouldn't
be included? (What about the following methods: tableCell? file_field?
ps? pre?)
* Any missing (or extraneous) attributes?
* Any inaccuracies? (I assume that currently there are many.)
* Should this be folded into, or linked to from, the User Guide?
* Should this page contain usage examples (simple and complex) or link
to them in the User Guide?
* Can someone add descriptions for :method and :action, above?
* Other suggestions?
I have made a number of other edits to the rdoc but am not ready to
submit a second patch yet. I hope to post it by Wednesday.
Cheers,
Jeff
_______________________________________________
Wtr-general mailing list
Wtr-general@rubyforge.org
http://rubyforge.org/mailman/listinfo/wtr-general
