{"action":"created","issue":{"url":"https://api.github.com/repos/w3c/html/issues/169","repository_url":"https://api.github.com/repos/w3c/html","labels_url":"https://api.github.com/repos/w3c/html/issues/169/labels{/name}","comments_url":"https://api.github.com/repos/w3c/html/issues/169/comments","events_url":"https://api.github.com/repos/w3c/html/issues/169/events","html_url":"https://github.com/w3c/html/issues/169","id":146562239,"number":169,"title":"Do not recommend using nested sections with h1","user":{"login":"chaals","id":4714748,"avatar_url":"https://avatars.githubusercontent.com/u/4714748?v=3","gravatar_id":"","url":"https://api.github.com/users/chaals","html_url":"https://github.com/chaals","followers_url":"https://api.github.com/users/chaals/followers","following_url":"https://api.github.com/users/chaals/following{/other_user}","gists_url":"https://api.github.com/users/chaals/gists{/gist_id}","starred_url":"https://api.github.com/users/chaals/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/chaals/subscriptions","organizations_url":"https://api.github.com/users/chaals/orgs","repos_url":"https://api.github.com/users/chaals/repos","events_url":"https://api.github.com/users/chaals/events{/privacy}","received_events_url":"https://api.github.com/users/chaals/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/w3c/html/labels/match%20reality%20better","name":"match reality better","color":"c7def8"},{"url":"https://api.github.com/repos/w3c/html/labels/question%20for%20the%20WG","name":"question for the WG","color":"cc317c"},{"url":"https://api.github.com/repos/w3c/html/labels/Simple%20(seeming)%20bug","name":"Simple (seeming) bug","color":"f7c6c7"}],"state":"open","locked":false,"assignee":{"login":"chaals","id":4714748,"avatar_url":"https://avatars.githubusercontent.com/u/4714748?v=3","gravatar_id":"","url":"https://api.github.com/users/chaals","html_url":"https://github.com/chaals","followers_url":"https://api.github.com/users/chaals/followers","following_url":"https://api.github.com/users/chaals/following{/other_user}","gists_url":"https://api.github.com/users/chaals/gists{/gist_id}","starred_url":"https://api.github.com/users/chaals/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/chaals/subscriptions","organizations_url":"https://api.github.com/users/chaals/orgs","repos_url":"https://api.github.com/users/chaals/repos","events_url":"https://api.github.com/users/chaals/events{/privacy}","received_events_url":"https://api.github.com/users/chaals/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/w3c/html/milestones/1","html_url":"https://github.com/w3c/html/milestones/may2016","labels_url":"https://api.github.com/repos/w3c/html/milestones/1/labels","id":1689025,"number":1,"title":"may2016","description":null,"creator":{"login":"chaals","id":4714748,"avatar_url":"https://avatars.githubusercontent.com/u/4714748?v=3","gravatar_id":"","url":"https://api.github.com/users/chaals","html_url":"https://github.com/chaals","followers_url":"https://api.github.com/users/chaals/followers","following_url":"https://api.github.com/users/chaals/following{/other_user}","gists_url":"https://api.github.com/users/chaals/gists{/gist_id}","starred_url":"https://api.github.com/users/chaals/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/chaals/subscriptions","organizations_url":"https://api.github.com/users/chaals/orgs","repos_url":"https://api.github.com/users/chaals/repos","events_url":"https://api.github.com/users/chaals/events{/privacy}","received_events_url":"https://api.github.com/users/chaals/received_events","type":"User","site_admin":false},"open_issues":1,"closed_issues":0,"state":"open","created_at":"2016-04-07T09:37:47Z","updated_at":"2016-04-07T09:37:58Z","due_on":null,"closed_at":null},"comments":3,"created_at":"2016-04-07T09:37:58Z","updated_at":"2016-04-10T22:59:21Z","closed_at":null,"body":"Currently there are two recommended approaches to headings: using the `h1` - `h6` in a structured nesting order, or using nested `<section><h1>` blocks relying on the outline algorithm.\r\n\r\nDoing this **looks** right in modern browsers, which apply some simple CSS to make nested `h1` elements look similar to `h2` - `h6` according to the level of nesting. But the CSS used is pretty fragile, and the browsers report the level of heading e.g. through accessibility APIs as `h1` whatever their nesting level.\r\n\r\nI propose that we make a counter-recommendation **not** to use nested `<section><h1>` while browsers do not implement it reliably."},"comment":{"url":"https://api.github.com/repos/w3c/html/issues/comments/208087743","html_url":"https://github.com/w3c/html/issues/169#issuecomment-208087743","issue_url":"https://api.github.com/repos/w3c/html/issues/169","id":208087743,"user":{"login":"chaals","id":4714748,"avatar_url":"https://avatars.githubusercontent.com/u/4714748?v=3","gravatar_id":"","url":"https://api.github.com/users/chaals","html_url":"https://github.com/chaals","followers_url":"https://api.github.com/users/chaals/followers","following_url":"https://api.github.com/users/chaals/following{/other_user}","gists_url":"https://api.github.com/users/chaals/gists{/gist_id}","starred_url":"https://api.github.com/users/chaals/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/chaals/subscriptions","organizations_url":"https://api.github.com/users/chaals/orgs","repos_url":"https://api.github.com/users/chaals/repos","events_url":"https://api.github.com/users/chaals/events{/privacy}","received_events_url":"https://api.github.com/users/chaals/received_events","type":"User","site_admin":false},"created_at":"2016-04-10T22:59:21Z","updated_at":"2016-04-10T22:59:21Z","body":"Yes, but it then provides an outline algorithm and various examples that suggest using \r\n\r\n```\r\n<section>\r\n <h1>a heading</h1>\r\n <section>\r\n  <h1>a heading for a subsection</h1>\r\n```\r\n\r\nWhich seemed like a good idea, and has certain features that make it attractive.\r\nOne of the features that make it unattractive is that it doesn't work. Different people viewing the same content will get very different structures provided to them.\r\n\r\nSo my proposal is to remove everything that says using sectioning is enough to make the outline algorithm understand the nesting as a way to treat headers relative to each other, since in practice, it isn't. \r\n\r\nIf you use `<section><h1>…</h1>…<section><h1>`, user agents will provide different information to different users. It seems that the attempt to change that has failed, and unless browsers are actively interested in fixing that - and it's probably not hard for them to do - we might as well deal with the problem. IMHO…"}}