[OpenLayers-Users] Control documentation incomplete, inconsistent and misleading

[Andreas Hocevar]

P Kishor wrote:
> On Thu, Sep 10, 2009 at 1:21 PM, Andreas Hocevar <ahocevar at opengeo.org> wrote:
>> So if you are still willing to contribute, a patch for that would be nice.
>> If you do not want to follow the procedure on
>> http://trac.openlayers.org/wiki/HowToContribute, then please let me know
>> what you would like to read in the docs for the constructor arguments, and I
>> will change the docs.
> 
> 
> I will be happy to follow the procedures at HowToContribute, but that
> link, as far as I can see, does not indicate on how to contribute
> new/better documentation.

For API documentation (which is generated from the source code), the 
same procedure applies. For changes to http://docs.openlayers.org/, 
patches against http://svn.openlayers.org/trunk/doc/ are welcome.

> Seems like my only option is to send the
> docs to you, and that seems to be ok with you.

It is ok this time, since it seems you have suffered enough already :-).

> By the way, I discovered one more place where documentation is almost
> non-existent, and the behavior is inconsistent -- that is in how OL
> calls WMS vs. MapServer. Once again, the answer was in a mailing list
> archive. I can send that also to you. Just let me know.

Well, while we're at it, just send it my way too.

Regards,
Andreas.

-- 
Andreas Hocevar
OpenGeo - http://opengeo.org/
Expert service straight from the developers.