{"action":"created","issue":{"url":"https://api.github.com/repos/golang/gddo/issues/297","labels_url":"https://api.github.com/repos/golang/gddo/issues/297/labels{/name}","comments_url":"https://api.github.com/repos/golang/gddo/issues/297/comments","events_url":"https://api.github.com/repos/golang/gddo/issues/297/events","html_url":"https://github.com/golang/gddo/issues/297","id":98063353,"number":297,"title":"Field & function comments are low contrast and hard to read","user":{"login":"natefinch","id":3185864,"avatar_url":"https://avatars.githubusercontent.com/u/3185864?v=3","gravatar_id":"","url":"https://api.github.com/users/natefinch","html_url":"https://github.com/natefinch","followers_url":"https://api.github.com/users/natefinch/followers","following_url":"https://api.github.com/users/natefinch/following{/other_user}","gists_url":"https://api.github.com/users/natefinch/gists{/gist_id}","starred_url":"https://api.github.com/users/natefinch/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/natefinch/subscriptions","organizations_url":"https://api.github.com/users/natefinch/orgs","repos_url":"https://api.github.com/users/natefinch/repos","events_url":"https://api.github.com/users/natefinch/events{/privacy}","received_events_url":"https://api.github.com/users/natefinch/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":5,"created_at":"2015-07-30T01:24:17Z","updated_at":"2015-07-30T13:33:38Z","closed_at":null,"body":"In many packages, comments on struct fields and interface fields can get quite long, for example http://godoc.org/golang.org/x/net/context#Context - but the current stylesheets make the comments a real strain to read, even for someone with good eyesight.. the dark gray on light gray is a beast to read for any length of time.\r\n\r\nThis feels like a case where form is overriding function.  First and foremost, the text of godoc must be legible.\r\n\r\nI suggest lightening the background of comments (&lt;pre&gt; blocks), and darkening the text inside them in order to increase contrast and make them easier to read.  \r\n\r\nIn some trials in my browser, lightening the backround on &lt;pre&gt; blocks from #f5f5f5 to #FAFAFA made a big difference.  Darkening the main text to real black (#000) and darkening the comments to rgb(85,85,85) (#555555) makes the comments much more legible, while still being slightly distinguishable from the non-comments by brightness (though the fact that they're preceded by // should be more than enough).  The lightened &lt;pre&gt; background was still very easy to distinguish from non-pre blocks.\r\n\r\nI can submit a PR if the powers that be think it is worthwhile.\r\n\r\n**Here's a screen shot of current godoc.org:**\r\n![godoc-orig](https://cloud.githubusercontent.com/assets/3185864/8973886/ce5fbea4-3638-11e5-8ffc-ed4f4ec9b482.png)\r\n\r\n**And here it is with my suggested changes:**\r\n![godoc-mod](https://cloud.githubusercontent.com/assets/3185864/8973890/d7a4714e-3638-11e5-8e9a-7b763dbd2324.png)\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/golang/gddo/issues/comments/126325750","html_url":"https://github.com/golang/gddo/issues/297#issuecomment-126325750","issue_url":"https://api.github.com/repos/golang/gddo/issues/297","id":126325750,"user":{"login":"natefinch","id":3185864,"avatar_url":"https://avatars.githubusercontent.com/u/3185864?v=3","gravatar_id":"","url":"https://api.github.com/users/natefinch","html_url":"https://github.com/natefinch","followers_url":"https://api.github.com/users/natefinch/followers","following_url":"https://api.github.com/users/natefinch/following{/other_user}","gists_url":"https://api.github.com/users/natefinch/gists{/gist_id}","starred_url":"https://api.github.com/users/natefinch/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/natefinch/subscriptions","organizations_url":"https://api.github.com/users/natefinch/orgs","repos_url":"https://api.github.com/users/natefinch/repos","events_url":"https://api.github.com/users/natefinch/events{/privacy}","received_events_url":"https://api.github.com/users/natefinch/received_events","type":"User","site_admin":false},"created_at":"2015-07-30T13:33:38Z","updated_at":"2015-07-30T13:33:38Z","body":"FWIW, here's how it looks in Firefox on my machine: (again, on Linux, in case that matters)\r\n![godoc-firefox](https://cloud.githubusercontent.com/assets/3185864/8984181/f615c26c-369d-11e5-8f3e-c4d355feaf9f.png)\r\n"}}