Re: [OSM-talk] Map Features usefulness, usability and maintainability

2016-05-28 Thread Jochen Topf
On Sa, Mai 28, 2016 at 08:32:27 +, Andrew Hain wrote:
> The Map Features page is a long standing page on the wiki linked from its
> left sidebar and it has been translated into a large number of languages.
> 
> Unfortunately there are clear signs of difficulties of maintenance. Tags are
> regularly added with the wrong wiki variable copied and pasted that makes
> the description for a tag wrong in languages other than English until
> someone notices. Versions of the page in some languages have message boxes
> saying that parts of the page are out of date because page authors didn’t
> follow the intended structure. There is no way to link from the main columns
> to tag documentation that is newly created in the current language without
> updating the link manually; trying to do so from tag descriptions has had
> awkward side effects. Currently the page is not fully rendered in three
> languages with a fourth that is only complete because one of the templates
> has been removed.
> 
> It may be practical to sit down and strip back some of the accumulation of
> edits by a large number of different people that have added up to where we
> are now or to take on board new wiki technologies such as Lua scripting. But
> before we do that I think it’s worthwhile to think about what we actually
> need: whether the page should look the way it does, whether it belongs on
> the wiki, how we can keep it up to date and indeed whether other sources of
> documentation are actually more useful.

I totally agree that the manual maintainance is a nightmare. That's why I
added the "TagLists" function to taginfo, which can more or less automatically
create such feature lists from the descriptions of the tags in the info boxes
on the individual key and tag pages.

See https://wiki.openstreetmap.org/wiki/Taginfo/Taglists for all the details.

Unfortunately I din't have the time to persue this and nobody else worked on
integrating this into the wiki on the MapFeatures and other pages. But the
feature is finished and working. It is "just" a matter of replacing the old
manual lists by the template. The largest effort is consolidating the
descriptions and/or images from the individual key and tag pages and the lists
on MapFeatures. Where those descriptions/images are not the same it might
make sense to update the descriptions on the individual pages to not loose the
possibly better descriptions from the MapFeatures list.

Jochen
-- 
Jochen Topf  joc...@remote.org  http://www.jochentopf.com/  +49-351-31778688

___
talk mailing list
talk@openstreetmap.org
https://lists.openstreetmap.org/listinfo/talk


[OSM-talk] Map Features usefulness, usability and maintainability

2016-05-28 Thread Andrew Hain
The Map Features page is a long standing page on the wiki linked from its
left sidebar and it has been translated into a large number of languages.

Unfortunately there are clear signs of difficulties of maintenance. Tags are
regularly added with the wrong wiki variable copied and pasted that makes
the description for a tag wrong in languages other than English until
someone notices. Versions of the page in some languages have message boxes
saying that parts of the page are out of date because page authors didn’t
follow the intended structure. There is no way to link from the main columns
to tag documentation that is newly created in the current language without
updating the link manually; trying to do so from tag descriptions has had
awkward side effects. Currently the page is not fully rendered in three
languages with a fourth that is only complete because one of the templates
has been removed.

It may be practical to sit down and strip back some of the accumulation of
edits by a large number of different people that have added up to where we
are now or to take on board new wiki technologies such as Lua scripting. But
before we do that I think it’s worthwhile to think about what we actually
need: whether the page should look the way it does, whether it belongs on
the wiki, how we can keep it up to date and indeed whether other sources of
documentation are actually more useful.

--
Andrew
___
talk mailing list
talk@openstreetmap.org
https://lists.openstreetmap.org/listinfo/talk