[OpenLayers-Users] Poll: Common pitfalls when using OpenLayers / what annoys you the most?

[Dave Potts]

Hi
I think you might want to add the callback details as well, for an example
look at the Savestratgy callback listed for the current level of
documentation.  The arguments for the callbacks are not listed

eg
http://dev.openlayers.org/releases/OpenLayers-2.10/doc/apidocs/files/OpenLayers/Strategy/Save-js.html
http://dev.openlayers.org/releases/OpenLayers-2.10/doc/apidocs/files/OpenLayers/Handler/Click-js.html

The method for deleting a web feature item can only be discovered by
reading one of the example program, even then you have to set an internal
flag to make it work.

I think openlayers is a very useful, but its documentation does let it
down somewhat.

Dave.

> Hi Roald,
>
> thanks for the feedback. I'd put your point under the following headline:
>
> "API-doc improvements (ingherited methods and properties)"
>
> OK?
>
> Best regards,
> Marc
>
>
>
> On 05.08.2011 10:58, Roald de Wit wrote:
>> Hi,
>>
>> One thing that bugs me every now and then is the API docs: they don't
>> show inherited properties/methods for a class. Finding out what
>> methods a class implements can be a pain.
>>
>> Cheers, Roald
>>
>> On 05/08/11 17:26, Marc Jansen wrote:
>>> Hi all,
>>>
>>> for my talk "Common pitfalls for users of OpenLayers" [1] at this years
>>> FOSS4G [2] I want to evaluate the parts of OpenLayers where users of
>>> the
>>> library experience problems.
>>>
>>> You would help me -- and the project itself -- a lot if you could
>>> answer
>>> in this thread and tell me what problems you had working with
>>> OpenLayers.
>>>
>>> Please do not hesitate to tell us what has bugged you, what was unclear
>>> or non-intuitive. Provide us with the sall and the big annoyances Of
>>> course you are heavily encouraged to provide ways around the pitfalls
>>> and possible enhancements.
>>>
>>> I want to identify areas which often cause problems... and eventually I
>>> plan on making the library better where this is possible.
>>>
>>> Anyone is invited to share his/her thoughts -- so if you want the
>>> library to improve, go on and tell us where we can make things better.
>>>
>>> Thanks in advance,
>>> Marc
>>>
>>>
>>> [1] http://2011.foss4g.org/sessions/common-pitfalls-users-openlayers
>>> [2] http://2011.foss4g.org/
>>> _______________________________________________
>>> Users mailing list
>>> Users at lists.osgeo.org
>>> http://lists.osgeo.org/mailman/listinfo/openlayers-users
>> _______________________________________________
>> Users mailing list
>> Users at lists.osgeo.org
>> http://lists.osgeo.org/mailman/listinfo/openlayers-users
>>
>
> _______________________________________________
> Users mailing list
> Users at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/openlayers-users
>