openstreetmap/iD

Create some searchable documentation

Open

#11,684 opened on Dec 14, 2025

View on GitHub
 (11 comments) (0 reactions) (0 assignees)JavaScript (1,449 forks)github user discovery
documentationenhancementhelp wanted

Repository metrics

Stars
 (3,818 stars)
PR merge metrics
 (PR metrics pending)

Description

URL

https://community.openstreetmap.org/t/why-is-it-ok-that-id-performs-undiscussed-semiautomatic-distributed-mass-edits/139011/57

How to reproduce the issue?

Currently, what documentation there is for iD is only available as unselectable and unsearchable text in inside the iD window after clicking "?" at the bottom right of the help window.

In addition, a lot of information seems to be missing altogether - see https://community.openstreetmap.org/t/id-visibility-of-relations/138374 for some of the things that are missing (see comments like "It isn’t terribly discoverable").

Screenshot(s) or anything else?

No response

Which deployed environments do you see the issue in?

No response

What version numbers does this issue effect?

No response

Which browsers are you seeing this problem on?

No response

Contributor guide

Research direction
Investigate the existing help system in iD to understand how documentation is rendered and how to make text selectable and searchable. Look into HTML/CSS/JS changes needed.
Tech stack
javascript
Domain
frontend
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
None
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70