Fancy editing the map the whole internet quietly relies on? Here's the catch

A viral guide promises you can improve OpenStreetMap in 15 minutes flat - but seasoned contributors reckon there's an easier way in, and a few things worth knowing first.

Silver imac on brown wooden desk
Photo · Workperch / Unsplash

A tutorial doing the rounds this week promises to get you making a genuine contribution to OpenStreetMap (OSM) in under 15 minutes, no cartography degree required. The pitch: install a chunky Java app, add a website link to your local chippy, and watch your edit ripple out into dozens of apps that quietly run on OSM data. It’s a nice idea. Whether it’s actually the easiest way in is another matter.

What the guide actually asks you to do

The walkthrough, hosted on GitHub Pages, tells you to create an OSM account, download JOSM (the Java-based desktop editor, weighing in at roughly 365MB), install a plugin called Website Wizard, then filter your local area down to shops and amenities that are missing a website tag. You search for the business online, paste in the official URL, and upload the change. The logic holds up: once a place has a verified website attached, it becomes far easier for OSM and the tools built on it to later pull in accurate opening hours, phone numbers and email addresses too.

That’s the known, checkable bit. It works as described, and it is a genuinely small, low-risk edit - you’re adding one link to one existing entry, not redrawing a street.

So is JOSM actually the best way to start?

Here’s the catch, and it comes straight from people who’ve actually done this. On Hacker News, where the guide picked up over 400 upvotes and nearly a hundred comments, several longtime contributors pushed back on the “download a 365MB desktop app” approach entirely. One commenter, who started mapping after a bike trail was resurfaced near their home, argued newcomers should skip JOSM altogether and go straight to editing via OSM’s own website, or use a lightweight mobile app such as Every Door, which is built specifically for surveying local businesses on foot.

Their broader point: rather than hunting for missing website tags from a desktop, it’s more satisfying - and arguably more useful - to walk your own neighbourhood, spot the shop that closed two years ago or the restaurant that’s still listed under its old name, and fix that. Another commenter noted Every Door has its own rough edges, including glitchy map tiles and a fiddly reload process, so it’s not a flawless alternative either. There’s also a StreetComplete app mentioned in the same thread, which surfaces missing details - crossing accessibility, street lighting - as simple prompts as you move around.

None of this contradicts the original guide so much as it questions whether JOSM, a fairly heavyweight tool built for power users, is really the friendliest entry point for a first-timer.

What it means for you

If you want to try it, nothing here is risky: adding a website link to a shop is a reversible, low-stakes edit, and OSM data does genuinely feed into a wide range of apps and services beyond the big commercial map providers. But “15 minutes” assumes a smooth install and a willingness to learn a fairly dense desktop tool. If that sounds like a chore, the more casual route - a mobile app and a walk round the block - is what actual contributors say got them hooked in the first place.

Either way, the real value isn’t the specific method - it’s that OSM, unlike Google or Apple’s maps, is edited by ordinary people, and a five-minute fix to your local high street genuinely sticks.

Sources