In brief: uMap is a webapp that allows you to create a map with OSM layers, add markers/polygons, display OSM objects from Overpass queries, … Then you can embed your map in your site.
Find more info and the differents servers in the wiki.
How do I become a “noob uMap contributor”
Everything began during the OSM-fr administration board of february 15-16 2020 (brief in french here).
During this event OSM-fr board members talked about many stuff including uMap and the fact that they were looking for new contributors to its code.
In the meantime, I started several months ago to create some maps in uMap: for public bookcases
and other stuffs.
So I started to look to the 307 uMap issues and was really happy to answer to some of them.
But I was not able to add tags to issues and close already resolved issues.
Fortunately, jocelynj was attending the administration board this weekend. jocelynj is one of the maintainer of the main umap server: https://umap.openstreetmap.fr
So he put me in contact with the main uMap developer: yohanboniface.
Yohan names me “collaborator” in GitHub uMap project. So I started to triage all the 307 issues by applying tags, answering to bug reporters and so on.
During this task, I notice that the exact same questions were asked several times: “I can not open my map”, “how to do this/that”, and so on. So I decided to write new articles in the wiki:
I continue by triaging issues, some were about “translations” (aka localization) in differents languages. So I decided to look around this and update uMap localizations. I made a PR for it and wrote some documentation about how to upgrade translations.
After that, I was looking for more translators in the forum. Simon Poole answered me and adviced me to migrate uMap Transifex project to the main OSM Transifex Team. So we did it with his help. I really hope uMap is gonna get more translators to help us. If you are interested, feel free to contribute.
Then, I started to kack the code a bit and asked yohan to give me write access to the GitHub repository. So here is my really first code contribution pushed to the repo. It adresses this issues.
My “work” during one week
In one week of “spare time” (cause yes I have a full time job and other hobbies):
- I adressed and closed 28 tickets.
- I triaged and tagged about 100 tickets.
- I created and push to master 2 PR.
- I created 3 others PR.
- I started to work on 2 existing PR.
- I create 2 articles in wiki and improve existing articles.
From technical POV, uMap is a webapp in JavaScript with Leaflet for the front and Python with Django for the backend. And about me, I am more a web developer, I never develop with Python before so i will learn with uMap.
How to contribute to uMap?
If you are interested by contributing to uMap feel free to:
- Translate uMap with Transifex.
- Fix uMap tranlation issues.
- Review translations in Transifex.
- Give your point of view in the various issues & PR.
- Answer to issues.
- Submit new issues if you find some.
- Review and comment the existing PR.
- Adress existing issues by creating new PR.
- And so on.
And now?
Next step for me is to make an announcement on Weekly OSM to rally more translators/contributors.
And of course, I will continue to learn “how to maintain uMap” and try to improve uMap on my spare time.
If I can I will join the Toulouse Hack Weekend April 2020.