x/website: a modern or better design for golang.org / godoc.org / Go's official websites #9936

redstrike · 2015-02-19T21:06:00Z

Hello,

Go is very awesome, but I think Go's official websites should have a better design. It's really not eyes-friendly / eyes-catching for looking up tutorials, docs, API references. They should have a better syntax highlight themes. For someone who is not a hardcore programmer or native English speaker like me, it's really terrible to scan/skim/read the contents on Go's websites. The poor design of official websites makes Golang looks like an old programming language (this is the feeling not logic).

Below is random websites which are eyes-friendly / eyes-catching than Go's:
http://developer.android.com/
https://developer.apple.com/swift/
https://www.python.org/
http://symfony.com/
https://www.djangoproject.com/
http://laravel.com/
http://fatfreeframework.com/home
http://hacklang.org/
http://hhvm.com/
http://php.net/

Forgive me if your eyes have no problems while looking up for docs, API refs on Golang's websites :)

parkr · 2015-02-19T21:08:16Z

I actually really prefer the aesthetic of Golang.org and Godoc.org. Due to the lack of noise and fluff, it is really easy to read and make contributions to. I think it's great as-is.

adg · 2015-02-19T21:22:57Z

It is very subjective, but the web site needs work and I hope to have it
improved over the next few months.

On 20 February 2015 at 08:08, Parker Moore notifications@github.com wrote:

I actually really prefer the aesthetic of Golang.org and Godoc.org. Due to
the lack of noise and fluff, it is really easy to read and make
contributions to. I think it's great as-is.

—
Reply to this email directly or view it on GitHub
#9936 (comment).

bcmills · 2019-05-07T16:56:24Z

CC @spf13

spf13 · 2019-05-07T19:28:37Z

@andybons and I have been working on this for the past while. We should have something up in the next few weeks.

gopherbot · 2019-05-15T23:49:32Z

Change https://golang.org/cl/177498 mentions this issue: godoc/util: serve SVG files raw

When a godoc Presentation is serving a file, it will sniff its contents to determine if it contains "human-readable" text. If it does, then it serves the contents of the file with surrounding HTML. SVG files should not be served with any additional HTML even though their contents are not a binary format (just like CSS or JS files). Updates golang/go#9936 Change-Id: Id3dd3b6cda4f103b08f6e924923426a86bd46ec8 Reviewed-on: https://go-review.googlesource.com/c/tools/+/177498 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>

gopherbot · 2019-05-20T18:08:53Z

Change https://golang.org/cl/178137 mentions this issue: content/static: revamp main header and clean up markup

This is the first of many changes to spiff up golang.org a bit to include our updated branding and iterate on the design. Updates the html to be more modern and rewrites the header CSS to be in line with our style guide (golang.org/wiki/CSSStyleGuide). Additionally, removes the play popup widget in the header nav in favor of linking directly to the playground and formats the CSS using prettier. Updates golang/go#9936 Change-Id: I9baf727f9e703b560ef786277b5d9859baa6fbfc Reviewed-on: https://go-review.googlesource.com/c/website/+/178137 Reviewed-by: Katie Hockman <katie@golang.org>

gopherbot · 2019-05-20T20:49:38Z

Change https://golang.org/cl/178138 mentions this issue: content/static, internal/dl: update header on downloads page

The downloads page does not share the root template as other pages. Update it to use the new header markup. Also fixes an issue where static.go did not contain the Go logo and updates the downloads page to be consistent with others when visiting from China. Updates golang/go#9936 Fixes golang/go#32151 Change-Id: Ic6d703ccb8fe5cf93d74256bac41ecad69a78e72 Reviewed-on: https://go-review.googlesource.com/c/website/+/178138 Reviewed-by: Katie Hockman <katie@golang.org>

gopherbot · 2019-05-22T01:51:06Z

Change https://golang.org/cl/178437 mentions this issue: content/static: fix header styling problems

+ On Firefox, the menu items were not vertically aligned. Fixed by ensuring the nav element is display: flex. + Don’t show unwanted border radius, margin, and padding on mobile devices and desktop Safari. + Adjust horizontal padding on smaller viewports. + Underline links when they’re focused. Updates golang/go#9936 Change-Id: I2fb65a559a0498660b6d863a7fe29c8347cdc3ce Reviewed-on: https://go-review.googlesource.com/c/website/+/178437 Reviewed-by: Katie Hockman <katie@golang.org>

gopherbot · 2019-06-06T14:20:37Z

Change https://golang.org/cl/180959 mentions this issue: cmd/golangorg,content/static: render homepage using local root.html

gopherbot · 2019-06-06T16:33:15Z

Change https://golang.org/cl/180997 mentions this issue: content/static: clean up homepage to address various issues

This change alters the behavior to use a local copy of root.html to render the homepage of golang.org. It is copied directly from revision b7422f212878c68807c76351abc3fa02c5f6e7bd of doc/root.html in the main go repository. This will enable changes to be made to the homepage without having to cherry pick them to a release branch. Updates golang/go#9936 Updates golang/go#29206 Change-Id: I68a6ef017b969f8838f466721bce51c1b8a358d8 Reviewed-on: https://go-review.googlesource.com/c/website/+/180959 Reviewed-by: Katie Hockman <katie@golang.org> Reviewed-by: Chris Broadfoot <cbro@golang.org>

+ Replace tabs with spaces in root.html + Adds ARIA labels to form elements that are missing them + Removes unused playground popup code + Changes the primary container tag from div to main to indicate a page landmark + Updates the videos randomly displayed + Sets the rel attribute on cross-origin links to improve performance and increase security + Use textContent instead of innerHTML when constructing the blog feed content since it's faster and safer Updates golang/go#9936 Change-Id: I7b2cac3ad89ac2ee0044d7e19322b0b0e1bfa5cb Reviewed-on: https://go-review.googlesource.com/c/website/+/180997 Reviewed-by: Katie Hockman <katie@golang.org>

gopherbot · 2019-06-12T19:37:38Z

Change https://golang.org/cl/181339 mentions this issue: content/static: update styling of homepage

+ Change body font to Roboto, falling back to sans-serif + Rearrange sections so that the download and blog sections are on the left side of the page in desktop + Update button styles + Further encapsulation of CSS classes for homepage components + Various other cleanup items Updates golang/go#9936 Change-Id: Id3899c2a12500d69eeee41ed9b14a85dac908000 Reviewed-on: https://go-review.googlesource.com/c/website/+/181339 Reviewed-by: Andrew Gerrand <adg@golang.org> Reviewed-by: Katie Hockman <katie@golang.org>

gopherbot · 2019-06-18T19:09:47Z

Change https://golang.org/cl/182798 mentions this issue: content/static: update playground select to not zoom on mobile

gopherbot · 2019-06-19T21:01:43Z

Change https://golang.org/cl/183038 mentions this issue: cmd/golangorg, content/static: update site footer with new design

Additionally converts some viewport units to rems to be consistent Updates golang/go#9936 Change-Id: Ie93e55e7c7c0f555a1b29103b0f535e4752cab1b Reviewed-on: https://go-review.googlesource.com/c/website/+/182798 Reviewed-by: Katie Hockman <katie@golang.org>

This also adds a new page, copyright.html, with the longer copyright text currently in the footer. Some minor changes were made to godocs.js to ensure that a UI element used by the analysis features is hidden properly. Otherwise a black line shows up at the bottom of the page. Updates golang/go#9936 Change-Id: Ie92b3b5a97d4969b7499f9e1ef9f8fad337b3aa0 Reviewed-on: https://go-review.googlesource.com/c/website/+/183038 Reviewed-by: Katie Hockman <katie@golang.org>

gopherbot · 2019-07-08T18:28:42Z

Change https://golang.org/cl/185259 mentions this issue: internal/dl: update download template to use new footer

Also ensures link text for the download buttons matches the rest of the site. Updates golang/go#9936 Change-Id: Ic86c3680b055a25649c36de691d629e8d8c2dbe6 Reviewed-on: https://go-review.googlesource.com/c/website/+/185259 Reviewed-by: Alexander Rakoczy <alex@golang.org>

gopherbot · 2019-08-08T17:19:53Z

Change https://golang.org/cl/189457 mentions this issue: all: update to use new Go branding guidelines

Additionally makes some small changes to abide by best practices. Updates golang/go#9936 Change-Id: I88263ef78548365b3cfb3f14bae48deb01d30f4f Reviewed-on: https://go-review.googlesource.com/c/blog/+/189457 Reviewed-by: Katie Hockman <katie@golang.org>

Additionally makes some small changes to abide by best practices. Updates golang/go#9936 Change-Id: I88263ef78548365b3cfb3f14bae48deb01d30f4f Reviewed-on: https://go-review.googlesource.com/c/blog/+/189457 Reviewed-by: Katie Hockman <katie@golang.org> X-Blog-Commit: aa01e95eb6354b603c44fd2e75d578e6827ce7ce

seankhliao · 2021-12-21T21:04:09Z

I believe this is mostly covered by the consolidation onto go.dev as announced by the blog post