[faq] Added 'advanced osm editing' section #229

Merged
root merged 5 commits from osm into master 2024-04-11 19:45:10 +00:00
Contributor

Added an 'advanced osm editing' section to the faq, so this page can be linked to in organicmaps/organicmaps#7748.

See also #203

Added an 'advanced osm editing' section to the faq, so this page can be linked to in https://git.omaps.dev/organicmaps/organicmaps/pulls/7748. See also #203
biodranik (Migrated from github.com) reviewed 2024-04-07 13:23:17 +00:00
biodranik (Migrated from github.com) commented 2024-04-07 13:13:46 +00:00

Let's highlight that ID is for desktops only, and recommend other options for mobile users (they should go before details about how to use ID on the desktop.

Let's highlight that ID is for desktops only, and recommend other options for mobile users (they should go before details about how to use ID on the desktop.
biodranik (Migrated from github.com) commented 2024-04-07 13:16:42 +00:00
title: How can I do more advanced map editing in Organic Maps?

Most of the users never heard about OSM before, and won't understand what it means in the title/google search result.

```suggestion title: How can I do more advanced map editing in Organic Maps? ``` Most of the users never heard about OSM before, and won't understand what it means in the title/google search result.
biodranik (Migrated from github.com) commented 2024-04-07 13:19:24 +00:00

It's better to focus this page on two simple things:

  1. Teach new users about OSM.
  2. Recommend other editors (focus on mobile ones!). And make a link to another FAQ page "How to fix map errors using web ID editor?", it may have different recommendations, including how to copy a link to the place from OM by clicking on coordinates (there is an osm link there too), and other details.
It's better to focus this page on two simple things: 1. Teach new users about OSM. 2. Recommend other editors (focus on mobile ones!). And make a link to another FAQ page "How to fix map errors using web ID editor?", it may have different recommendations, including how to copy a link to the place from OM by clicking on coordinates (there is an osm link there too), and other details.
biodranik (Migrated from github.com) commented 2024-04-07 13:20:16 +00:00

Maybe add a paragraph how/when map data is updated here or below.

Maybe add a paragraph how/when map data is updated here or below.
biodranik (Migrated from github.com) commented 2024-04-07 13:20:50 +00:00

A better option is to move it to a separate FAQ page and link from this page.

A better option is to move it to a separate FAQ page and link from this page.
biodranik (Migrated from github.com) commented 2024-04-07 13:20:58 +00:00
2. Browse to the location you want to edit on OpenStreetMap.org and click *Edit*
```suggestion 2. Browse to the location you want to edit on OpenStreetMap.org and click *Edit* ```
biodranik (Migrated from github.com) commented 2024-04-07 13:21:11 +00:00

A direct "edit" link to osm can be inserted, right?

A direct "edit" link to osm can be inserted, right?
biodranik (Migrated from github.com) commented 2024-04-07 13:22:02 +00:00
1. Create a new account or log in at [OpenStreetMap.org](https://www.openstreetmap.org)
```suggestion 1. Create a new account or log in at [OpenStreetMap.org](https://www.openstreetmap.org) ```
biodranik (Migrated from github.com) commented 2024-04-07 13:22:27 +00:00

A hint on how to extract coordinates or osm URL from OM can be helpful

A hint on how to extract coordinates or osm URL from OM can be helpful
map-per reviewed 2024-04-07 15:49:57 +00:00
Author
Contributor

Ok, but I would rather use "How can I do more advanced map editing?".

Ok, but I would rather use "How can I do more advanced map editing?".
map-per reviewed 2024-04-07 15:53:43 +00:00
Author
Contributor

The problem is, that there are no mobile editors that are good for beginners and can do "advanced" edits (see organicmaps/organicmaps#7748 (comment)). So ID on a desktop PC is the only good option.

The problem is, that there are no mobile editors that are good for beginners and can do "advanced" edits (see https://git.omaps.dev/organicmaps/organicmaps/pulls/7748#issuecomment-2035347759). So ID on a desktop PC is the only good option.
map-per reviewed 2024-04-07 15:58:44 +00:00
Author
Contributor

A direct "edit" link to osm can be inserted, right?

Using the OSMCarto map for zooming to the right location first is more convenient. On older devices zooming or moving the map in ID can be very slow on lower zoom levels.

A hint on how to extract coordinates or osm URL from OM can be helpful

But then you have the coordinates in the clipboard of your phone and not on the desktop PC

> A direct "edit" link to osm can be inserted, right? Using the OSMCarto map for zooming to the right location first is more convenient. On older devices zooming or moving the map in ID can be very slow on lower zoom levels. > A hint on how to extract coordinates or osm URL from OM can be helpful But then you have the coordinates in the clipboard of your phone and not on the desktop PC
biodranik (Migrated from github.com) reviewed 2024-04-07 16:20:24 +00:00
biodranik (Migrated from github.com) commented 2024-04-07 16:20:24 +00:00

What "advanced" cases for new users, in your opinion, can't be handled with existing mobile editors?

Forcing all mobile users to "find and use desktop to edit the map" doesn't look like a good idea. Most new users won't need really "advanced" stuff, from what we see, users need something simpler, that just can't be added/edited yet in OM.
At least a list of user options is needed for mobiles. I would say, that Vespucci and Go! Map can cover most of the cases.

What "advanced" cases for new users, in your opinion, can't be handled with existing mobile editors? Forcing all mobile users to "find and use desktop to edit the map" doesn't look like a good idea. Most new users won't need really "advanced" stuff, from what we see, users need something simpler, that just can't be added/edited yet in OM. At least a list of user options is needed for mobiles. I would say, that Vespucci and Go! Map can cover most of the cases.
biodranik (Migrated from github.com) reviewed 2024-04-07 16:22:16 +00:00
biodranik (Migrated from github.com) commented 2024-04-07 16:22:16 +00:00

We are trying to optimize here the UX for completely new users, not aware of OSM, and who came from the mobile OM app. They need something really simple to get involved. Later, they can learn more about OSM and about any advanced use cases.

We are trying to optimize here the UX for _completely new_ users, not aware of OSM, and who came from the mobile OM app. They need something really _simple_ to get involved. Later, they can learn more about OSM and about any advanced use cases.
map-per reviewed 2024-04-07 16:41:37 +00:00
Author
Contributor

I can't say anything about Go! Map, as it's ios only, but Vespucci is rather complicated to use. But mentioning it any way is probably a good idea, as it is the only android editor that can do "advanced" stuff like adding a new road.

Osm Go! and Every Door can only edit POIs and with StreetComplete you can only answer simple quests. So with "advanced" I meant doing more than just editing POIs. So e.g. adding a new road or a building shape.

Have you tried out mobile editors so far? And if yes, how was your experience?

I can't say anything about Go! Map, as it's ios only, but Vespucci is rather complicated to use. But mentioning it any way is probably a good idea, as it is the only android editor that can do "advanced" stuff like adding a new road. Osm Go! and Every Door can only edit POIs and with StreetComplete you can only answer simple quests. So with "advanced" I meant doing more than just editing POIs. So e.g. adding a new road or a building shape. Have you tried out mobile editors so far? And if yes, how was your experience?
biodranik (Migrated from github.com) reviewed 2024-04-07 18:20:39 +00:00
biodranik (Migrated from github.com) commented 2024-04-07 18:20:39 +00:00

"Go! Map" is good enough for mobile. Using it to draw ways and fix areas rarely.

Then the text in the app should be clearer: "Simple map editing apps like Every Door or StreetComplete, or more advanced Vespucci" for Android and "Every Door app for simple map edits, and more advanced Go! Map"

"Go! Map" is good enough for mobile. Using it to draw ways and fix areas rarely. Then the text in the app should be clearer: "Simple map editing apps like Every Door or StreetComplete, or more advanced Vespucci" for Android and "Every Door app for simple map edits, and more advanced Go! Map"
map-per reviewed 2024-04-08 10:02:46 +00:00
Author
Contributor

No, I think that rather belongs into a different faq

No, I think that rather belongs into a different faq
Author
Contributor

I updated the faq page:

  • I added mobile editor, but placed ID first as editing is easier on a bigger screen and with mouse and keyboard.
  • I left everyting in one faq page as scattering the text would make it hard to read
I updated the faq page: - I added mobile editor, but placed ID first as editing is easier on a bigger screen and with mouse and keyboard. - I left everyting in one faq page as scattering the text would make it hard to read
biodranik (Migrated from github.com) reviewed 2024-04-08 10:46:50 +00:00
biodranik (Migrated from github.com) left a comment

Thanks! A few comments.

Thanks! A few comments.
biodranik (Migrated from github.com) commented 2024-04-08 10:36:47 +00:00
For editing OSM, there are several options. If you have a laptop or desktop computer at hand, it's better to use the [ID Editor](https://www.openstreetmap.org/edit) that runs in your browser. The ID Editor is easy for beginners, and a bigger screen, mouse, and keyboard make map editing easier.
```suggestion For editing OSM, there are several options. If you have a laptop or desktop computer at hand, it's better to use the [ID Editor](https://www.openstreetmap.org/edit) that runs in your browser. The ID Editor is easy for beginners, and a bigger screen, mouse, and keyboard make map editing easier. ```
biodranik (Migrated from github.com) commented 2024-04-08 10:41:00 +00:00
For advanced map editing from a mobile device, use [Go!! Map](https://apps.apple.com/us/app/go-map/id592990211) for iOS or [Vespucci](https://play.google.com/store/apps/details?id=de.blau.android) for Android. Go Map is easy for beginners, while Vespucci targets more advanced users.

For simpler edits with more fun, you may also try [Every Door app](https://every-door.app/) for iOS and Android and [StreetComplete app](https://streetcomplete.app/) for Android.
```suggestion For advanced map editing from a mobile device, use [Go!! Map](https://apps.apple.com/us/app/go-map/id592990211) for iOS or [Vespucci](https://play.google.com/store/apps/details?id=de.blau.android) for Android. Go Map is easy for beginners, while Vespucci targets more advanced users. For simpler edits with more fun, you may also try [Every Door app](https://every-door.app/) for iOS and Android and [StreetComplete app](https://streetcomplete.app/) for Android. ```
biodranik (Migrated from github.com) commented 2024-04-08 10:41:40 +00:00

Following succinct OM style in FAQ is beneficial too )

```suggestion ``` Following succinct OM style in FAQ is beneficial too )
biodranik (Migrated from github.com) commented 2024-04-08 10:42:09 +00:00
2. Browse to the location you want to edit on OpenStreetMap.org and click *Edit* at the top
```suggestion 2. Browse to the location you want to edit on OpenStreetMap.org and click *Edit* at the top ```
biodranik (Migrated from github.com) commented 2024-04-08 10:43:45 +00:00

Can these tutorial hints be embedded above, where these editors are referenced? Or maybe a separate section "Tutorials" would be better?

Can these tutorial hints be embedded above, where these editors are referenced? Or maybe a separate section "Tutorials" would be better?
biodranik (Migrated from github.com) commented 2024-04-08 10:45:01 +00:00

Any live discussion channels? List of telegram/other messenger groups? Remember, our audience is not a geeky one.

Any live discussion channels? List of telegram/other messenger groups? Remember, our audience is not a geeky one.
@ -0,0 +33,4 @@
That's it, you are now part of the OSM community.
## What happens with my edits?
biodranik (Migrated from github.com) commented 2024-04-08 10:44:15 +00:00

Need to clarify when edits appear in Organic Maps

Need to clarify when edits appear in Organic Maps
@ -0,0 +55,4 @@
## OSM Notes
If you don't have time or the problem is too complicated for editing the OSM data yourself OSM Notes ([Wiki](https://wiki.openstreetmap.org/wiki/Notes)) are the way to go. You can place such a note in the location of the map error and describe the problem in detail. Other OSM volunteers can then help and solve the issue. You will get e-mail notifications via your OSM account in case they have further questions or the OSM Note is solved.
biodranik (Migrated from github.com) commented 2024-04-08 10:46:42 +00:00

It's better to leave an empty line after each header.

It's better to leave an empty line after each header.
@ -0,0 +59,4 @@
1. Create a new account or log in at [OpenStreetMap.org](https://www.openstreetmap.org)
> You can also open anonymous Notes, but this is not recomended as you won't get notified when the issue is solved or there are further questions.
2. Zoom to the map location on [OpenStreetMap.org](https://www.openstreetmap.org) and press *Add a note to the map* (second icon from the bottom on the right menue). Then drag the blue map marker to the exact location.
biodranik (Migrated from github.com) commented 2024-04-08 10:46:26 +00:00

Is this numbered list properly rendered by Zola?

Is this numbered list properly rendered by Zola?
map-per reviewed 2024-04-08 13:07:32 +00:00
Author
Contributor

The help and support page in the OSM Forum is the main place for questions. But there are also other channels (see: https://wiki.openstreetmap.org/wiki/Contact_channels). I haven't tried out any of them though.

The help and support page in the OSM Forum is the main place for questions. But there are also other channels (see: https://wiki.openstreetmap.org/wiki/Contact_channels). I haven't tried out any of them though.
map-per reviewed 2024-04-08 13:11:37 +00:00
Author
Contributor

👍 I moved the tutorial hints to the editor overview

:+1: I moved the tutorial hints to the editor overview
map-per reviewed 2024-04-08 13:12:57 +00:00
@ -0,0 +59,4 @@
1. Create a new account or log in at [OpenStreetMap.org](https://www.openstreetmap.org)
> You can also open anonymous Notes, but this is not recomended as you won't get notified when the issue is solved or there are further questions.
2. Zoom to the map location on [OpenStreetMap.org](https://www.openstreetmap.org) and press *Add a note to the map* (second icon from the bottom on the right menue). Then drag the blue map marker to the exact location.
Author
Contributor

Added   to have more space between the quote and the next list element

Added ` ` to have more space between the quote and the next list element
Author
Contributor

Updated the faq page and included your suggestions.

Updated the faq page and included your suggestions.
biodranik commented 2024-04-09 07:26:54 +00:00 (Migrated from github.com)

@map-per FYI for the future PRs: with a write access to the repo, if you push a branch here, then its preview can be available for anyone.

@map-per FYI for the future PRs: with a write access to the repo, if you push a branch here, then its preview can be available for anyone.
biodranik commented 2024-04-09 07:48:57 +00:00 (Migrated from github.com)

We can proceed with the PR to unblock other tasks, although the text already looks too complicated for a non-geeky, non-OSM user. It would be great to stick to the most important, precise, succinct info for new users on the initial page, and move any details for those who are interested to a different page. Otherwise, there is a risk that your grandma just closes the long web page with a lot of text without reading it, and won't proceed with any contributions.

You can test it with OM + a link to this page combo with any (non-geeky) person who didn't know about OM and OSM before.

We can proceed with the PR to unblock other tasks, although the text already looks too complicated for a non-geeky, non-OSM user. It would be great to stick to the most important, precise, succinct info for new users on the initial page, and move any details for those who are interested to a different page. Otherwise, there is a risk that your grandma just closes the long web page with a lot of text without reading it, and won't proceed with any contributions. You can test it with OM + a link to this page combo with any (non-geeky) person who didn't know about OM and OSM before.
biodranik (Migrated from github.com) reviewed 2024-04-09 07:49:49 +00:00
@ -0,0 +59,4 @@
1. Create a new account or log in at [OpenStreetMap.org](https://www.openstreetmap.org)
> You can also open anonymous Notes, but this is not recomended as you won't get notified when the issue is solved or there are further questions.
2. Zoom to the map location on [OpenStreetMap.org](https://www.openstreetmap.org) and press *Add a note to the map* (second icon from the bottom on the right menue). Then drag the blue map marker to the exact location.
biodranik (Migrated from github.com) commented 2024-04-09 07:49:49 +00:00

Please don't do that. No visual formatting with the content. It should be done with CSS, I've pushed a fix.

Please don't do that. No visual formatting with the content. It should be done with CSS, I've pushed a fix.
Author
Contributor

I think it's OK that this page explains more difficult content, as it is about advanced editing.

For simple editing with OM we should create a separate faq page.

I think it's OK that this page explains more difficult content, as it is about **advanced** editing. For **simple** editing with OM we should create a separate faq page.
biodranik commented 2024-04-09 08:14:37 +00:00 (Migrated from github.com)

There is an important UX flow nuance: all OM users (including complete newbies) will see the related message when they try to add something on the map and won't find the interested object.

That means that the landing page should be easy to digest for all OM users. Those who is interested in more advanced details, may click to read them.

There is an important UX flow nuance: _all_ OM users (including complete newbies) will see the related message when they try to add something on the map and won't find the interested object. That means that the landing page should be easy to digest for _all_ OM users. Those who is interested in more advanced details, may click to read them.
Author
Contributor

We can proceed with the PR to unblock other tasks

Then let's merge this and do further improvements in the next iterations

> We can proceed with the PR to unblock other tasks Then let's merge this and do further improvements in the next iterations
biodranik (Migrated from github.com) approved these changes 2024-04-11 19:44:46 +00:00
biodranik (Migrated from github.com) left a comment

Ok, any ideas on a web page for grannies?

Ok, any ideas on a web page for grannies?
Author
Contributor

We could move community, wiki and data model to a dedicated OpenStreetMap page. And as soon as we have an Organic Maps editing page (for grannies) we could move the OSM Notes section there.

I think, for the FAQ, the Organic Maps editing page is the highest priority now.

We could move community, wiki and data model to a dedicated OpenStreetMap page. And as soon as we have an Organic Maps editing page (for grannies) we could move the OSM Notes section there. I think, for the FAQ, the Organic Maps editing page is the highest priority now.
Sign in to join this conversation.
No description provided.