Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
redstrike opened this issue Feb 19, 2015 · 15 comments
Assignees
Milestone

Comments

@redstrike
Copy link

@redstrike redstrike commented Feb 19, 2015

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
Copy link

@parkr parkr commented Feb 19, 2015

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
Copy link
Contributor

@adg adg commented Feb 19, 2015

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).

@rsc rsc added this to the Unplanned milestone Apr 10, 2015
@golang golang locked and limited conversation to collaborators Oct 23, 2015
@golang golang unlocked this conversation May 7, 2019
@bcmills
Copy link
Member

@bcmills bcmills commented May 7, 2019

CC @spf13

@spf13
Copy link
Contributor

@spf13 spf13 commented May 7, 2019

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

@gopherbot
Copy link

@gopherbot gopherbot commented May 15, 2019

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

gopherbot pushed a commit to golang/tools that referenced this issue May 16, 2019
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
Copy link

@gopherbot gopherbot commented May 20, 2019

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

gopherbot pushed a commit to golang/website that referenced this issue May 20, 2019
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
Copy link

@gopherbot gopherbot commented May 20, 2019

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

gopherbot pushed a commit to golang/website that referenced this issue May 20, 2019
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
Copy link

@gopherbot gopherbot commented May 22, 2019

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

gopherbot pushed a commit to golang/website that referenced this issue May 23, 2019
+ 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>
@andybons andybons changed the title websites: a modern or better design for golang.org / godoc.org / Go's official websites x/website: a modern or better design for golang.org / godoc.org / Go's official websites Jun 6, 2019
@gopherbot
Copy link

@gopherbot gopherbot commented Jun 6, 2019

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

@gopherbot
Copy link

@gopherbot gopherbot commented Jun 6, 2019

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

gopherbot pushed a commit to golang/website that referenced this issue Jun 6, 2019
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>
gopherbot pushed a commit to golang/website that referenced this issue Jun 6, 2019
+ 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
Copy link

@gopherbot gopherbot commented Jun 12, 2019

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

gopherbot pushed a commit to golang/website that referenced this issue Jun 13, 2019
+ 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
Copy link

@gopherbot gopherbot commented Jun 18, 2019

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

@gopherbot
Copy link

@gopherbot gopherbot commented Jun 19, 2019

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

gopherbot pushed a commit to golang/website that referenced this issue Jun 19, 2019
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>
gopherbot pushed a commit to golang/website that referenced this issue Jun 20, 2019
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
Copy link

@gopherbot gopherbot commented Jul 8, 2019

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

gopherbot pushed a commit to golang/website that referenced this issue Jul 9, 2019
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
Copy link

@gopherbot gopherbot commented Aug 8, 2019

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

gopherbot pushed a commit to golang/blog that referenced this issue Aug 12, 2019
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>
@andybons andybons removed their assignment Sep 18, 2019
Bogdan-D pushed a commit to Bogdan-D/godocx that referenced this issue Nov 13, 2019
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
8 participants
You can’t perform that action at this time.