Live data from Hacker News

Web Fundamentals: A handbook for best practices

developers.google.com

1–10 of 66 posts

Re: Web Fundamentals: A handbook for best practices

#3
I don't find this site to be a fundamentally good example of usability.

It's not TERRIBLE, but given that they're speaking from a position of high-authority, it should be better.

Three examples:

(1) https://developers.google.com/web/fundamentals/documentation... - What am I supposed to click? The "2 guides" thingy looks like a button. No. Not clickable. But then just below are two identically colored "Create Amazing Forms" and "Add Touch to Your Site". Easily solvable with (a) buttons (b) underlined links (c) consistent navigation colors

(2) Click on "Getting Started" in the top navigation section. Would you expect that the text should now be bold, as it was on the home screen indicating which page / section I'm on?

(3) Back to this page "https://developers.google.com/web/fundamentals/documentation... - why is there a cookie-crumb nav element in Documentation that's not present on other subs like https://developers.google.com/web/fundamentals/resources/sty...

In their defense, I understand that their audience is "developers" who are going to be able to solve poor UX and find what they want.

But still feels like a moment to eat your own dogfood . . .

Re: Web Fundamentals: A handbook for best practices

#4
post #3

I don't find this site to be a fundamentally good example of usability. It's not TERRIBLE, but given that they're speaking from a position of high-authority, it should be better. Three examples: (1) https://developers.google.com/web/fundamentals/documentation... - What am I supposed to click? The "2 guides" thingy looks like a button. No. Not clickable. But then just below are two identically colored "Create Amazing…

Certainly! Good call. We soft launched the site today and are still very actively improving things. I like your suggestions though. I broke the menu and a fix is heading out soon. I'll file the others so we can get them addressed. [EDITED.]

Re: Web Fundamentals: A handbook for best practices

#5
post #4
post #3

I don't find this site to be a fundamentally good example of usability. It's not TERRIBLE, but given that they're speaking from a position of high-authority, it should be better. Three examples: (1) https://developers.google.com/web/fundamentals/documentation... - What am I supposed to click? The "2 guides" thingy looks like a button. No. Not clickable. But then just below are two identically colored "Create Amazing…

Certainly! Good call. We soft launched the site today and are still very actively improving things. I like your suggestions though. I broke the menu and a fix is heading out soon. I'll file the others so we can get them addressed. [EDITED.]

Added bugs https://github.com/google/WebFundamentals/issues 9,10,11

Re: Web Fundamentals: A handbook for best practices

#7

I see the performance stuff as the most useful. Otherwise, the general layout/responsive design pointers are pretty much common knowledge at this point (or so I think). Great starting point, would be nice to integrate with Pagespeed.

I have it on the plan to have PageSpeed on the front page and then it gives you a targeted doc plan. https://github.com/google/WebFundamentals/issues/12

Edit: there is also information that is common knowledge for a lot of advanced developers but for the rest of developers there are not many places that present a similar narrative.

Re: Web Fundamentals: A handbook for best practices

#8
post #4
post #3

I don't find this site to be a fundamentally good example of usability. It's not TERRIBLE, but given that they're speaking from a position of high-authority, it should be better. Three examples: (1) https://developers.google.com/web/fundamentals/documentation... - What am I supposed to click? The "2 guides" thingy looks like a button. No. Not clickable. But then just below are two identically colored "Create Amazing…

Certainly! Good call. We soft launched the site today and are still very actively improving things. I like your suggestions though. I broke the menu and a fix is heading out soon. I'll file the others so we can get them addressed. [EDITED.]

[deleted]

Re: Web Fundamentals: A handbook for best practices

#9
post #8
post #4

Earlier quoted context omitted.

Certainly! Good call. We soft launched the site today and are still very actively improving things. I like your suggestions though. I broke the menu and a fix is heading out soon. I'll file the others so we can get them addressed. [EDITED.]

[deleted]

:) thanks.

Re: Web Fundamentals: A handbook for best practices

#10
post #4
post #3

I don't find this site to be a fundamentally good example of usability. It's not TERRIBLE, but given that they're speaking from a position of high-authority, it should be better. Three examples: (1) https://developers.google.com/web/fundamentals/documentation... - What am I supposed to click? The "2 guides" thingy looks like a button. No. Not clickable. But then just below are two identically colored "Create Amazing…

Certainly! Good call. We soft launched the site today and are still very actively improving things. I like your suggestions though. I broke the menu and a fix is heading out soon. I'll file the others so we can get them addressed. [EDITED.]

a) Sorry to be a grumbler, I know how hard it is to launch anything. You rock for instantly adding these to git and I appreciate the response.

b) I spent a few more mins on the site after posting the comment, the lesson content is very strong.

I wonder if the content would be better served by removing the stuff below your headline on https://developers.google.com/web/fundamentals/ - eg those links are where I immediately got lost. If I'd clicked the Get Started and nothing else I would have had a much smoother experience.

Post reply on HN