Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Searchable online help #1971

Closed
SomeoneElseOSM opened this issue Nov 15, 2013 · 4 comments
Closed

Searchable online help #1971

SomeoneElseOSM opened this issue Nov 15, 2013 · 4 comments

Comments

@SomeoneElseOSM
Copy link

Currently there appears to be no searchable online help available for iD. There is

https://wiki.openstreetmap.org/wiki/Id
https://github.com/systemed/iD/wiki

but neither of these are very relevant. There's also the text of the "inline" help here:

https://github.com/systemed/iD/blob/master/dist/locales/en.json

but that's not really very easy to search - and even if you've found the text you're looking for, you don't see the context in which that piece of inline help would be displayed.

What's needed is some documentation that people can actually read, on a web page, and search, on the same web page. For example, if I want to undo an action the information that the inline help provides "you can undo changes by clicking the undo button" is not helpful if I don't know what the "undo" button looks like (and it's not actually labelled as such).

@tmcw
Copy link
Contributor

tmcw commented Nov 21, 2013

Happy to accept pull requests here; the priority of iD developers is contextual help, and keeping documentation up to date & comprehensive is a large expenditure of time.

@SomeoneElseOSM
Copy link
Author

Understood that you can't do everything before everything else, but unfortunately it's not going to be me that contributes any "how to use iD" text - despite a few months of trying on and off I've not figured out much more beyond "adding a node or a way" without resorting to the "all tags" dialogue.

It's a shame, because there are a substantial subset of questions coming in to "help.osm.org" that involve "have a read of the beginners' guide on the wiki" as part of the answer. That does have Potlatch 2 and JOSM sections but doesn't have an iD one, and the iD page http://wiki.openstreetmap.org/wiki/ID isn't really useful to refer to.

@bhousel
Copy link
Member

bhousel commented Mar 12, 2016

Closing, LearnOSM has built this: http://learnosm.org/en/beginner/id-editor/

@bhousel bhousel closed this as completed Mar 12, 2016
@SomeoneElseOSM
Copy link
Author

Unfortunately, 7 years later, there's still no searchable online help in iD.

There is a "help" button in the UI, which displays a message on the screen which looks like a clickable link titled "help". However, right-clicking on that and opening in new tab does not work - I just get another copy of the editor window.
There is also no link to http://learnosm.org/en/beginner/id-editor/ (which was suggested above).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants