[OpenLayers-Dev] Jugl and examples.js

[Tim Schaub]

The doc/examples.js script is generated by tools/exampleparser.py. 
Until today, I had not looked at either of these (though I recall when 
work was being done on this at FOSS4G).

I know that Chris has said that anything that can be auto-generated 
should not be included in the repository.  I see the sense in this, but 
I also think it puts a lot into the hands of the people who have access 
to the machines that do the auto part (generally, I think those are two 
hands).

In this case, since the code in examples.html (which is in the 
repository) depends very heavily on the examples.js that is generated by 
some unknown process (unknown to me), it feels a little weird.  For 
example, I changed the examples.html code just now (and the 
exampleparser.py).  This broke the page because I couldn't change the 
examples.js code that loads from http://openlayers.org/dev/doc/examples.js .

Perhaps this is no big deal.  But I have no idea how frequently this 
exampleparser.py is run.  Perhaps it is only at release time.  Perhaps 
it is only at 3am on New Years.  I know that Chris will be around in a 
few hours and will do whatever needs to be done.  But say he was on 
vacation, or what if he broke a finger playing Wii?

Anyway, this is minor.  But I would be interested in hearing ideas for 
spreading around the tasks that fall entirely on the shoulders of one 
currently.

Tim

And, in the meantime, I changed 
http://openlayers.org/dev/doc/examples.html so it loads an examples2.js 
that *is* in the repository.  Now we've got an interactive examples page!


John R. Frank wrote:
> Tim,
> 
> Should examples.js be part of the release tarball?
> 
> The doc/examples.html file doesn't render the list of examples without
> that file being added to the directory.
> 
> Also, what is the simplest way to modify that file so that it works
> properly when not connected to the Internet?
> 
> Thanks for your help,
> 
> John
> _______________________________________________
> Dev mailing list
> Dev at openlayers.org
> http://openlayers.org/mailman/listinfo/dev
> 
> !DSPAM:4033,481cc89e120991637810514!
>