[Catalyst] Test::WWW::Mechanize::Catalyst and POST

[Toby Corkindale]

Michael Alan Dorman wrote:
> Toby Corkindale <toby at ymogen.net> writes:
>> Ah, so once again, I am making the mistake of reading and *believing* 
>> the fine documentation? :(
> 
> You may have read it and believed it, but apparently you didn't think
> through the implications of it.
> 
> The first paragraph of the T::W::M::C docs say:
> 
>  Catalyst is an elegant MVC Web Application
>  Framework. Test::WWW::Mechanize is a sub-class of WWW::Mechanize that
>  incorporates features for web application testing.  The
>  Test::WWW::Mechanize::Catalyst module meshes the two to allow easy
>  testing of Catalyst applications without starting up a web server.
> 
> "sub-class" means that it inherits functionality from W::M.  It is
> neither sensible nor appropriate for T::W::M or T::W::M::C to
> recapitulate the documentation for all of their parent classes (where
> does one stop---should all modules document isa()?).  The
> documentation for W::M, though, has tons of discussion of stuff like
> submit_form.

Yet, T:W:M:C *does* recapitulate much of the documentation for T:W:M.

I agree with your statement that it is neither sensible nor appropriate 
to duplicate such documentation - however, it is even worse to do a 
half-arsed duplication of only *some* of it.