<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
Hi all,<br>
<br>
Since tags are now being used by the search box, I would add the notice
to provide comma-seperated tags for the respective example inside a div
with id = "tags", e.g.:<br>
<br>
<div id="tags"><br>
panning, animation, effect, smooth, panMethod<br>
</div><br>
<br>
While going through the examples at the FOSS4G codesprint, I again
realised that the presentation of the examples could possibly enhanced:<br>
<ul>
<li>The search box should auto-suggest (and -complete), since only
"full" matches will give results at all<br>
</li>
<li>maybe we could agree on certain standard tags like e.g.
"basic"/"enhanced", ... to naturally group the examples by topics</li>
<li>The tags under the shortdesc of the examples on the left side
should be clickable links, that do a search by the clicked tag</li>
<li>Every documentation file should include a link to the examples
page that filters the examples by an appropriate keyword, so that when
you are seeing the docs for OpenLayers.Layer.Google a link like
<a class="moz-txt-link-rfc2396E" href="http://openlayers.org/dev/examples/?q=google">"http://openlayers.org/dev/examples/?q=google"</a> is included</li>
<li>That would of course mean that these URL params need to parsed by
example-list.html</li>
<li>I would also provide the output of tools/exampleparser.py for
every release (That means checking in <span class="sourceRowText"
role="presentation">example-list.js and </span><span
class="sourceRowText" role="presentation">example-list.xml</span>).
AFAICT one currently needs to build this file when you download an
archive from the openlayers website. That way the search doesn't work
for someone without further work to do.<br>
</li>
</ul>
BTW: the list of examples for the current stable release
(<a class="moz-txt-link-freetext" href="http://dev.openlayers.org/releases/OpenLayers-2.10/examples/">http://dev.openlayers.org/releases/OpenLayers-2.10/examples/</a>) only
gives the directory listing instead of the example-list.html page. The
current trunk example list (<a class="moz-txt-link-freetext" href="http://openlayers.org/dev/examples/">http://openlayers.org/dev/examples/</a>) is
working as expected. Shall I file a bug on this?<br>
<br>
Just my two €-cents.<br>
<br>
Regards,<br>
Marc<br>
<br>
<br>
On 16.09.2010 22:45, Tim Schaub wrote:
<blockquote cite="mid:4C9281CF.7020801@opengeo.org" type="cite">Hey-
<br>
<br>
We've gotten feedback over the last couple years about our examples
generating a bit of confusion. Because, in general, we add to and do
not modify examples, we are not necessarily demonstrating
best-practices use of OpenLayers.
<br>
<br>
In addition to getting rid of examples that demonstrate the use of
deprecated code, I think we should update existing examples in a couple
ways. These are minor, but I think we should (at least) do the
following:
<br>
<br>
* use <!DOCTYPE html> (xhtml is dead)
<br>
* remove superfluous "/" attributes on elements that don't need a
closing tag (i.e. void elements like <br>, <link>,
<img>, and <input> don't have a closing tag)
<br>
* include script tags at the end of the body
<br>
<br>
Nothing urgent about this, but if folks want to provide patches for the
current example set, your contributions are welcome.
<br>
<br>
<a class="moz-txt-link-freetext" href="http://trac.osgeo.org/openlayers/wiki/CodingStandards#WritingExamples">http://trac.osgeo.org/openlayers/wiki/CodingStandards#WritingExamples</a>
<br>
<br>
Feedback welcome.
<br>
Tim
</blockquote>
<br>
</body>
</html>