{"action":"created","issue":{"url":"https://api.github.com/repos/openstreetmap/openstreetmap-website/issues/881","labels_url":"https://api.github.com/repos/openstreetmap/openstreetmap-website/issues/881/labels{/name}","comments_url":"https://api.github.com/repos/openstreetmap/openstreetmap-website/issues/881/comments","events_url":"https://api.github.com/repos/openstreetmap/openstreetmap-website/issues/881/events","html_url":"https://github.com/openstreetmap/openstreetmap-website/issues/881","id":55772981,"number":881,"title":"The welcome page should mention relations","user":{"login":"vincentdephily","id":115401,"avatar_url":"https://avatars.githubusercontent.com/u/115401?v=3","gravatar_id":"","url":"https://api.github.com/users/vincentdephily","html_url":"https://github.com/vincentdephily","followers_url":"https://api.github.com/users/vincentdephily/followers","following_url":"https://api.github.com/users/vincentdephily/following{/other_user}","gists_url":"https://api.github.com/users/vincentdephily/gists{/gist_id}","starred_url":"https://api.github.com/users/vincentdephily/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vincentdephily/subscriptions","organizations_url":"https://api.github.com/users/vincentdephily/orgs","repos_url":"https://api.github.com/users/vincentdephily/repos","events_url":"https://api.github.com/users/vincentdephily/events{/privacy}","received_events_url":"https://api.github.com/users/vincentdephily/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2015-01-28T15:48:33Z","updated_at":"2015-01-28T17:37:34Z","closed_at":null,"body":"http://www.openstreetmap.org/welcome mentions the OSM basics : editor, node, way, and tag. One important requirement for this page is that it should be as short as possible, which probably explains why relations are not mentioned.\r\n\r\nI'm now thinking that this is a mistake. Relation are one of the four building blocks of the OSM data model. It's becoming more unlikely every day that a user could edit the map without encountering relations. Because relations are not mentioned on the welcome page and are rather discreet in most editors, a newbie's first interaction with a relation will probably be to break it. And a lot of contributors prefer to avoid relations whenever possible, even if the workaround is akward.\r\n\r\nThis is all detrimental to OSM, so I suggest adding a one-line description like we have for the other elements. Something like \"A relation groups nodes and ways together to define areas, bus routes, or turn restrictions\"."},"comment":{"url":"https://api.github.com/repos/openstreetmap/openstreetmap-website/issues/comments/71878849","html_url":"https://github.com/openstreetmap/openstreetmap-website/issues/881#issuecomment-71878849","issue_url":"https://api.github.com/repos/openstreetmap/openstreetmap-website/issues/881","id":71878849,"user":{"login":"vincentdephily","id":115401,"avatar_url":"https://avatars.githubusercontent.com/u/115401?v=3","gravatar_id":"","url":"https://api.github.com/users/vincentdephily","html_url":"https://github.com/vincentdephily","followers_url":"https://api.github.com/users/vincentdephily/followers","following_url":"https://api.github.com/users/vincentdephily/following{/other_user}","gists_url":"https://api.github.com/users/vincentdephily/gists{/gist_id}","starred_url":"https://api.github.com/users/vincentdephily/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vincentdephily/subscriptions","organizations_url":"https://api.github.com/users/vincentdephily/orgs","repos_url":"https://api.github.com/users/vincentdephily/repos","events_url":"https://api.github.com/users/vincentdephily/events{/privacy}","received_events_url":"https://api.github.com/users/vincentdephily/received_events","type":"User","site_admin":false},"created_at":"2015-01-28T17:37:34Z","updated_at":"2015-01-28T17:37:34Z","body":"Being aware of relations is a small but necessary step.\r\n\r\nI don't have a working setup to prepare a PR, but I can hopefully skip that for a plain documentation change."}}