[uMap] End user documentation

Wed Nov 23 10:45:26 UTC 2016

Hi everyone,

A due update to warn that I heavily modified the French uMap Guide on 
the OSM wiki (https://wiki.openstreetmap.org/wiki/FR:UMap/Guide)

It should now be easier to add new tutorials & to translate existing 
ones.

Each tutorial has now it's own page, is categorized, and ready to be 
translated.

The main Guide page serves as a root : every tutorial is a now subpage 
of FR:UMap/Guide.

We also have 2 categories for uMap (Category:UMap and Category:FR:UMap), 
where you'll find useful images if you feel like adding your own 
tutorial.

If so, you can check this talk page 
(https://wiki.openstreetmap.org/wiki/FR_talk:UMap/Guide) where I explain 
what I did and give some advice on how to add new tutorials.

So, I guess now I have to find time to write more tutorials and to 
translate everything in english.

Cheers

Guillaume

Le 2016-10-07 07:44, Guillaume a écrit :
> Hi,
> 
> 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
> (http://wiki.cartocite.fr/doku.php?id=umap:4_-_je_modifie_et_personnalise_ma_carte),
> 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.
> 
> Cheers
> 
> Guillaume
> 
> 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
> 
> _______________________________________________
> Umap mailing list
> Umap at openstreetmap.org
> https://lists.openstreetmap.org/listinfo/umap