Hi Noli, thanks for the feedback. I'd put your point under the following headline:
"API-doc improvements (inline example code)" OK? Best regards, Marc On 05.08.2011 12:26, Noli Sicad wrote: > Hi, > > Just to add on the issue about OL documentation, there is very few > sample / example snippets source code on the documentation. If not, > not all on how to use the functions, methods and properties. > > Unlike the R package documentation, R has good sample code snippets > for almost everything. > > Just have a look at it. > http://cran.r-project.org/doc/manuals/R-intro.html#Getting-and-setting-attributes > > Note: the OL dev team acknowledge this deficiency. > > Thanks. > > Noli > > > > On 8/5/11, Marc Jansen <[email protected]> wrote: >> 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 >>>> [email protected] >>>> http://lists.osgeo.org/mailman/listinfo/openlayers-users >>> _______________________________________________ >>> Users mailing list >>> [email protected] >>> http://lists.osgeo.org/mailman/listinfo/openlayers-users >>> >> _______________________________________________ >> Users mailing list >> [email protected] >> http://lists.osgeo.org/mailman/listinfo/openlayers-users >> _______________________________________________ Users mailing list [email protected] http://lists.osgeo.org/mailman/listinfo/openlayers-users
