{"action":"created","issue":{"url":"https://api.github.com/repos/rust-lang/rust/issues/38843","repository_url":"https://api.github.com/repos/rust-lang/rust","labels_url":"https://api.github.com/repos/rust-lang/rust/issues/38843/labels{/name}","comments_url":"https://api.github.com/repos/rust-lang/rust/issues/38843/comments","events_url":"https://api.github.com/repos/rust-lang/rust/issues/38843/events","html_url":"https://github.com/rust-lang/rust/pull/38843","id":198883726,"number":38843,"title":"Improved rustdoc rendering for unstable features","user":{"login":"Manishearth","id":1617736,"avatar_url":"https://avatars.githubusercontent.com/u/1617736?v=3","gravatar_id":"","url":"https://api.github.com/users/Manishearth","html_url":"https://github.com/Manishearth","followers_url":"https://api.github.com/users/Manishearth/followers","following_url":"https://api.github.com/users/Manishearth/following{/other_user}","gists_url":"https://api.github.com/users/Manishearth/gists{/gist_id}","starred_url":"https://api.github.com/users/Manishearth/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Manishearth/subscriptions","organizations_url":"https://api.github.com/users/Manishearth/orgs","repos_url":"https://api.github.com/users/Manishearth/repos","events_url":"https://api.github.com/users/Manishearth/events{/privacy}","received_events_url":"https://api.github.com/users/Manishearth/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":{"login":"steveklabnik","id":27786,"avatar_url":"https://avatars.githubusercontent.com/u/27786?v=3","gravatar_id":"","url":"https://api.github.com/users/steveklabnik","html_url":"https://github.com/steveklabnik","followers_url":"https://api.github.com/users/steveklabnik/followers","following_url":"https://api.github.com/users/steveklabnik/following{/other_user}","gists_url":"https://api.github.com/users/steveklabnik/gists{/gist_id}","starred_url":"https://api.github.com/users/steveklabnik/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/steveklabnik/subscriptions","organizations_url":"https://api.github.com/users/steveklabnik/orgs","repos_url":"https://api.github.com/users/steveklabnik/repos","events_url":"https://api.github.com/users/steveklabnik/events{/privacy}","received_events_url":"https://api.github.com/users/steveklabnik/received_events","type":"User","site_admin":false},"assignees":[{"login":"steveklabnik","id":27786,"avatar_url":"https://avatars.githubusercontent.com/u/27786?v=3","gravatar_id":"","url":"https://api.github.com/users/steveklabnik","html_url":"https://github.com/steveklabnik","followers_url":"https://api.github.com/users/steveklabnik/followers","following_url":"https://api.github.com/users/steveklabnik/following{/other_user}","gists_url":"https://api.github.com/users/steveklabnik/gists{/gist_id}","starred_url":"https://api.github.com/users/steveklabnik/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/steveklabnik/subscriptions","organizations_url":"https://api.github.com/users/steveklabnik/orgs","repos_url":"https://api.github.com/users/steveklabnik/repos","events_url":"https://api.github.com/users/steveklabnik/events{/privacy}","received_events_url":"https://api.github.com/users/steveklabnik/received_events","type":"User","site_admin":false}],"milestone":null,"comments":11,"created_at":"2017-01-05T06:14:35Z","updated_at":"2017-01-05T18:37:25Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/rust-lang/rust/pulls/38843","html_url":"https://github.com/rust-lang/rust/pull/38843","diff_url":"https://github.com/rust-lang/rust/pull/38843.diff","patch_url":"https://github.com/rust-lang/rust/pull/38843.patch"},"body":"This replaces \"unstable\" with \"this is an experimental API\", and uses a `<details>` tag to expand to the reason.\r\n\r\nThe `<details>` tag renders as a regular div (with the details show) on browsers which don't support it, On browsers which do support it, it shows only the summary line with an expandy-arrow next to it, and on clicking it the details will turn up below it.\r\n\r\n\r\nThis is somewhat a strawman proposal. The main issue is that we need to improve our messaging around unstable APIs. Since they turn up in the docs, we should be clearer that they are experimental (and perhaps add something about nightly-only). I'm making this PR to kickstart discussion on this.\r\n\r\nExample rendering: http://manishearth.github.io/rust-internals-docs/std/io/trait.Read.html#method.chars\r\n\r\n<img width=\"375\" alt=\"screen shot 2017-01-04 at 10 15 37 pm\" src=\"https://cloud.githubusercontent.com/assets/1617736/21670712/5a96c7de-d2cb-11e6-86a6-87f70818d634.png\">\r\n\r\nexpands to\r\n\r\n<img width=\"799\" alt=\"screen shot 2017-01-04 at 10 15 43 pm\" src=\"https://cloud.githubusercontent.com/assets/1617736/21670714/5db88bb4-d2cb-11e6-8fcc-5cf11d198b75.png\">\r\n\r\n\r\ncc @steveklabnik @jdub"},"comment":{"url":"https://api.github.com/repos/rust-lang/rust/issues/comments/270720912","html_url":"https://github.com/rust-lang/rust/pull/38843#issuecomment-270720912","issue_url":"https://api.github.com/repos/rust-lang/rust/issues/38843","id":270720912,"user":{"login":"Manishearth","id":1617736,"avatar_url":"https://avatars.githubusercontent.com/u/1617736?v=3","gravatar_id":"","url":"https://api.github.com/users/Manishearth","html_url":"https://github.com/Manishearth","followers_url":"https://api.github.com/users/Manishearth/followers","following_url":"https://api.github.com/users/Manishearth/following{/other_user}","gists_url":"https://api.github.com/users/Manishearth/gists{/gist_id}","starred_url":"https://api.github.com/users/Manishearth/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Manishearth/subscriptions","organizations_url":"https://api.github.com/users/Manishearth/orgs","repos_url":"https://api.github.com/users/Manishearth/repos","events_url":"https://api.github.com/users/Manishearth/events{/privacy}","received_events_url":"https://api.github.com/users/Manishearth/received_events","type":"User","site_admin":false},"created_at":"2017-01-05T18:37:25Z","updated_at":"2017-01-05T18:37:25Z","body":"I don't see that being used in the docs anywhere?\r\n\r\n\r\nI noticed that not all APIs have extended unstable reasons, so I should probably fix up this PR to handle that (e.g. http://manishearth.github.io/rust-internals-docs/syntax/parse/fn.raw_str_lit.html)"}}
{"actor":{"display_login":"Manishearth"}}