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

Add a help jumping-off page #456

Closed
wants to merge 6 commits into from
Closed

Add a help jumping-off page #456

wants to merge 6 commits into from

Conversation

jfirebaugh
Copy link
Member

This adds a simple jump off page to OSM's most prominent sources of help and documentation -- the new welcome page, LearnOSM, help.osm.org, and wiki.osm.org.

The latter two were available in the sidebar under "Help", but space there is limited, and having a dedicated page permits some explanatory text as well as the addition of the welcome page and LearnOSM.

image

@systemed
Copy link
Contributor

LearnOSM desperately needs iD/P2-friendly copy before it's a sensible recommendation for newbies, I fear.

pnorman added a commit to osmlab/openstreetmap-upcoming-features that referenced this pull request Aug 19, 2013
@sabas
Copy link

sabas commented Aug 19, 2013

On iD hotosm/learnosm#114

@tomhughes
Copy link
Member

I've put a test site up at http://help.apis.dev.openstreetmap.org/help although you can basically see everything in the screen shot above anyway.

@tomhughes
Copy link
Member

The problem, in my eyes, with LearnOSM isn't that it needs an chapter on iD as well as/instead of the Potlatch 2 chapter (which appears to be blank anyway) in the book part of the site, but rather the main HTML part.

A new user is going to go to LearnOSM and hit the big green "New to OpenStreetMap?" button and then get to the "Getting Started Editing" section and be faced with instructions on how to download and install JOSM which is not a user friendly way to get somebody mapping...

@lxbarth
Copy link
Contributor

lxbarth commented Aug 23, 2013

Agree, let's make adding LearnOSM a separate issue from introducing the help page.

@jfirebaugh
Copy link
Member Author

Should we just remove LearnOSM for now?

@lxbarth
Copy link
Contributor

lxbarth commented Aug 23, 2013

Should we just remove LearnOSM for now?

+1

@woodpeck
Copy link
Contributor

Do what you like but somehow I find the logic "we don't have a 'learn how to edit OSM with iD' resource so we'd rather remain silent about existing 'learn how to edit OSM with JOSM' resources a bit strange. What is this, the House Committee on Un-iD Editors? While we're at it, let's remove all JOSM references from the Wiki because "someone who wants to use JOSM will find out anyway", right?

@systemed
Copy link
Contributor

Oh Frederik, do calm down. :)

That really isn't what's being suggested at all. The issue is that if there is a button that says "Learn OSM", the well-intentioned newbie will click on it, because they want to learn how to use OSM. They will be told "first download JOSM", and will do so. They will then be told they need this thing called "Java", and will go and find that. After about half an hour their head will hurt, and they'll give up on OSM and do something else.

That's not an attack on JOSM, just an acknowledgement that you should perhaps fly something light and simple before trying to pilot the Starship Enterprise. Until LearnOSM gets an iD tutorial, "Learn advanced editing" would be splendid alternative link text.

@pnorman
Copy link
Contributor

pnorman commented Sep 25, 2013

It's been about a month - what needs to be done, if anything, to move this forwards?

@tomhughes
Copy link
Member

Well deciding what to do about LearnOSM is the main outstanding point isn't it? Alex suggested dropping it but I don't think that has actually been done.

@jfirebaugh
Copy link
Member Author

Dropped LearnOSM and updated the layout to account for the user menu.

@pnorman
Copy link
Contributor

pnorman commented Oct 2, 2013

👍

We'll probably want to expand the links as we get more material of course.

@pnorman pnorman mentioned this pull request Oct 2, 2013
18 tasks
@tomhughes
Copy link
Member

This has been added by #498 as part of the redesign.

@tomhughes tomhughes closed this Nov 28, 2013
@jfirebaugh jfirebaugh deleted the help-page branch December 2, 2013 22:10
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

Successfully merging this pull request may close these issues.

8 participants