User:Ikanot

I'm new to OSM, but I'll be happy to learn.

I'm mostly using OSM through uMap & Overpass to make maps.

I'm also making tutorials for uMap, in french & english

Ikanot (talk)

uMap tutorials guideline

uMap tutorials guideline

• Only screenshot the english version on the app
  • URL = https://umap.openstreetmap.fr/en/
  • Exception : if the screenshot is supposed to be read by the user, it can be in his language
• Make screenshots reusable for other uMap tutorials
  • Multipurpose screenshot = easier maintenance
  • I KNOW this is bad practice, and not user orientated enough, but for now this is easier
• Keep screenshot light-weighted, but zoomable
  • 1200px wide is fine, may be up to 1500px
• Categorize tutorials and screenshots with Category:UMap or Category:FR:UMap
  • Otherwise nobody will find them, ever.
• Keep text to bare minimum
  • Less text + short sentences = easier translation & maintenance
• Keep tutorials task orientated
  • Tutorials don't teach, they do not give an overview or describe the functionalities
  • They guide through a step by step process, so the user manages to do a specific task
• Keep tutorials specific : 1 task = 1 tutorial
  • If it's a different action or task, it's a different tutorial
  • If you feel you need to fork your explanation, you probably need to fork you tutorial
• Use descriptive, search-friendly titles
  • Name of the tuto = the question the average user is googling / searching
• Keep all tutorials a subpage of your UMap/Guide
  • English tutos = UMap/Guide/
  • French tutos = FR:UMap/Guide/
  • Beware ! URL is UMap, not Umap
• Keep tutorials independent
  • Nobody should need to read another tutorial to do what this one is explaining
  • This obviously has a few exception, but it's a good general rule
• Double-check you didn't miss a step
  • Missing a step or assuming it's implicit is the best way to confuse and lose the reader
• Don't be Captain Obvious
  • User don't need tutorial to do task that are obvious
  • Document things that :
    • require many clicks / are buried in a sub-menu
    • could not be guess (ex: you can configure how the data browser filter works)
    • took you some time to master yourself
• Test your tutorials

Personal todolist

Avancement Ikanot/Guide

to do list

Tutos à faire en priorité

• Renommer une carte (sans casser les liens)
  • Le vrai intérêt c'est d'expliquer que les liens sont réécrits et ne cassent pas.
• Choisir une icone personnalisée ✔
• à titrer - Configurer la recherche (filtre) dans le visualiseur de données
• Afficher une barre de légende
• à titrer - Donner des informations sur l'auteur de la carte
• Choisir le niveau de zoom et le centrage par défaut
  • l'occasion de parler des niveaux de zoom et des long/lat dans l'url ?
• Choisir qui peut éditer ma uMap ✔
  • régler les permissions
• Autoriser un utilisateur à modifier une uMap ✔
• FR:UMap/Guide/Choisir qui peut consulter ma uMap ✔
  • l'occasion de préciser que les cartes sont référencées par les mdr
• Créer une copie d'une carte (cloner)
• Choisir l'interface par défaut
  • pb : différencier ce qui règle de l'interface / l'interaction
  • cacher / supprimer des menus ou des infos (échelle)
  • ouvrir le visualisateur ou le panneau latéral au chargement
  • minicarte
  • fond de carte par défaut
  • légende ?
  • copyright ?

Tutos à faire / importer (moins prio)

• Choisir la licence de sa uMap
• Changer le propriétaire d'une uMap
• Limiter la uMap à une zone géographique

Tutos à faire... par quelqu'un d'autre

• Diaporama --> j'y capte rien
• Fond de carte personnalisé --> idem
• Utiliser des données d'OSM (simple)
  • importer juste les données d'une zone géographique
  • importer des données sans limite géographique
  • pb : limitations du serveur / de l'appli inconnues

À faire, pas un tuto

• Topo sur les 3 niveaux de modif : point, layer, défaut
  • cf. meme menus ou presque, dur de faire un tuto pour chaque niveau
  • + notion d'héritage
• Comprendre l'URL d'une carte ?
  • domaine.tld/langue/map/nomdemacarte_idcarte#zoom/lat/long
  • domaine.tld/langue/map/nomdemacarte_idcarte#zoom/lat/long?parametre=valeur&parametre=valeur
• Feature list de uMap sur la page principale
  • les features pourraient directement linker vers le tuto pour les faire
• Globalement, page principale plus claire
  • qu'est ce que uMap
  • ce que ça fait (feature list)
  • showcase
  • apprendre uMap (déplacer tout l'apprentissage vers la section Guide)
  • participer
    • avec en + participer en traduisant / écrivant des tutos

to do list