[uMap] End user documentation

Guillaume compte.umap at whoz.me
Fri Oct 7 05:44:44 UTC 2016


I agree the OSM Wiki is the right place, and it already provides a way
to deal with multilingual documentation.

Rather than to translated word for word, I think that breaking existing
tutorials in smaller pieces may be easier to translate and maintain.

This would lead to more pages, with less info per page, but with
search-friendly titles (and plenty of screenshots).

For instance this page
may be help to build :

wiki.openstreetmap.org/wiki/UMap/Guide/Find a uMap
wiki.openstreetmap.org/wiki/UMap/Guide/Change titlelayers
wiki.openstreetmap.org/wiki/UMap/Guide/Clone a uMap
wiki.openstreetmap.org/wiki/UMap/Guide/Delete a uMap
and so on.

wiki.openstreetmap.org/wiki/UMap/Guide/ could then become the main
entrance to more specific tutorials pages. At least that's how I picture
it for now.



On 06/10/2016 18:28, Antoine Riche wrote:
> Hi Guillaume.
> I wrote those tutorials and put them on my DokuWiki mostly because I'm
> familiar with DokuWiki. I really intend to carry on writing the series
> however I'm struggling to find the time.  In addition the new version of
> uMap implies to update the existing tutorials. This shows you're right :
> the tutorials should be placed in a more central place where they can be
> edited and maintained by several people.
> The OSM Wiki seems to me to be the right place. Converting DokuWiki to
> MediaWiki doesn't look so easy though.  Where do we start ? One
> possibility would be to translate the existing tutorials to english and
> put them on the OSM wiki - I can send you the source code of the
> DokuWiki tutorials. Do let me know if you have other ideas.
> Cheers,
> Antoine.
> Le 05/10/2016 à 20:50, Guillaume a écrit :
>> Thanks,
>> Cartocite's tutorials are a solid start for an end user documentation,
>> but they can't be updated and improved by an open community.
>> This is a shame, especially with the new version of Umap, which should
>> lead to updates in these tutorials.
>> I think Umap could benefit from some knowledge base / wiki /
>> documentation website that any mapper could edit.
>> The links on Cartocite's wiki have been red for some time now. With a
>> proper place to contribute, some of the missing tutorials could be
>> written by others.
>> Cheers
>> Guillaume
>> PS : and yes, I'm French, despite my interest in an english
>> documentation :)
>> On 05/10/2016 18:47, Thomas Gratier wrote:
>>> Hi,
>>> You can look at
>>> http://wiki.cartocite.fr/doku.php?id=umap:tutoriel_umap#niveau_debutant
>>> for
>>> a good structured "Umap getting started" (OK, it's in French but you are
>>> French it seems ;))
>>> It could be a good content for starting an "official" tutorial maybe.
>>> For other Umap resources, as you stated, it's mainly on the
>>> OpenStreetMap
>>> wiki in various pages.
>>> Cheers
>>> Thomas Gratier
>>> 2016-10-05 18:15 GMT+02:00 Guillaume <compte.umap at whoz.me>:
>>>> Hi everyone,
>>>> I don't find any end user documentation for Umap. Is there any ? And if
>>>> not, would anyone interested in building / writing one ?
>>>> I know there are resources to learn & teach Umap, but they're scattered
>>>> throughout wiki pages, tutorials on blogs, forums, and OSM Q/A help.
>>>> It's not as easy as having end user documentation in a single place,
>>>> where
>>>> people can easily get into Umap, learn how to use it and improve their
>>>> mapping skills.
>>>> I often discover great Umaps, and find myself wondering "How was it
>>>> made ?
>>>> How can I do something cool like that ?"... And then I'm stuck and
>>>> can't
>>>> find an answer.
>>>> So, if there's a end user documentation : where is it ? If there
>>>> isn't, it
>>>> would be nice to have a place to start writing it.
>>>> Cheers
>>>> Guillaume
>>>> _______________________________________________
>>>> Umap mailing list
>>>> Umap at openstreetmap.org
>>>> https://lists.openstreetmap.org/listinfo/umap
>> _______________________________________________
>> Umap mailing list
>> Umap at openstreetmap.org
>> https://lists.openstreetmap.org/listinfo/umap
> _______________________________________________
> Umap mailing list
> Umap at openstreetmap.org
> https://lists.openstreetmap.org/listinfo/umap

More information about the Umap mailing list