[OpenLayers-Dev] Re: OpenLayers API doc

Matt Priour mpriour at kestrelcomputer.com
Tue Aug 9 15:07:11 EDT 2011

I think the similarity between Natural Docs and JSDoc that the majority of
conversion could be done via script.
There are more documentation options and IDE's that understand JSDoc than
Natural Docs. So I think it certainly couldn't hurt.

However, I agree with Christopher that the real need is walkthrough style
tutorials and possibly even a "code playground" similar to what Google APIs
has. Additionally, regularly highlighting uses of OpenLayers in the wild
would help people understand what is possible with this great library. The
issue is and always has been that such documentation and community
cheerleading takes time and that is a very expensive commodity for most of
the active OpenLayers devs and power users.

Matt Priour
Kestrel Computer Consulting

Matt Priour
Kestrel Computer Consulting
View this message in context: http://osgeo-org.1803224.n2.nabble.com/OpenLayers-API-doc-tp6667194p6669324.html
Sent from the OpenLayers Dev mailing list archive at Nabble.com.

More information about the Dev mailing list