Join GitHub today
GitHub is home to over 50 million developers working together to host and review code, manage projects, and build software together.Sign up
x/pkgsite: Design Changes Harm Readability #37862
(I scanned through issues with
What is the URL of the page with the issue?
What is your user agent?
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.122 Safari/537.36
What did you do?
Visit the page
What did you expect to see?
What did you see instead?
A variety of style changes, mainly font-related, that in my opinion (stated as such) are not improvements, and which make the documentation harder to read.
Again, these are all my opinions, but since you are asking for feedback, I would suggest:
In closing, godoc.org is fantastic! I would suggest we slavishly copy it unless the Go Team is getting a lot of requests to change it (which you might, I don't know).
I am having the same problem. I always try to skip the new site and now I am afraid it will replace the documentation site.
Note the comparison below have a zoom on the new website of 80% instead of 100% to at least have some margin on the sides. (With 100%)
I am not a design expert so it is hard for me to know what the possible solutions are. Here are some of the notes I believe makes my experience worse in the new website:
Hope it helps.