search

google / WebFundamentals

Former git repo for WebFundamentals on developers.google.com
Apache License 2.0
13.85k stars 2.57k forks source link

Please put this in English..... #6932

Open aowanders opened 5 years ago

aowanders commented 5 years ago

Welcome! Please use this template for reporting documentation issues on https://developers.google.com/web/.

For questions about Chrome DevTools, checkout the google-chrome-devtools tag on StackOverflow. For questions about Chrome, check the google-chrome tag. If you think you've found a Chrome bug, check out our feedback page for more details on how to file it.

Page Affected: https://developers.google.com/web/TODO

What needs to be done?

When I click on the learn more button about an issue i expect to ..... "learn more" not become more confused. Can you please put this in the version of English that non coders and non developers speak so I know what to type into google or what to include on my project description when I try to hire a freelancer to fix an issue.

I would love to fix it myself, but after reading 20 minutes I still have no idea what my issue is. Literally no help! All I learned from this tutorial was how to use websters online dictionary because you chose a version of the English language that is the "minority" in everyday use!

Seriously this is the 1st or 2nd sentence in your "learn more" quote unquote "help page"

You can improve your page load speed by inlining links and scripts that are required for first paint, and deferring those that aren't.

lets break this down..

inlining links means...............................what exactly??

Scripts kind of understand. those are small programs that tell a website what to load right?

required for first paint????? what the fuck??? come on. there has to be a simpler easier more understandable sentence that can be used here instead of " required for first paint" Who would understand what this 4 word combination means other than a coder? In today era of drag and drop or choose a plugin to install.........most website owners don't even know where their file manager folder is located. I barely know html. Kind of know CSS, and have a loose grasp on javascript, and with that very limited understanding or lets say exposure I would still be ranked above the average website owner..

AND I STILL HAVE NO IDEA WHAT REQUIRED FOR FIRST PAINT EVEN REFERS TO.

THAT MEANS THERE ARE LITERALLY MILLIONS OF WEBSITE OWNERS OUT THERE THAT DON'T EVEN HAVE THE LIMITED AMOUNT OF TECHNICAL SKILLS THAT I DO TO UNDERSTAND THAT.

YOUR 'learn more' page does nothing related to learn more.

out of all the choices of words you chose ??????????? REQUIRED FOR FIRST PAINT??????????????????

COME ON. WHEN YOUR WRITING YOUR TUTORIAL YOU RIGHT FOR 7TH GRADE RETARDISM. NOT Ph.D SOFTWARE ENGINEERS.

LITERALLY MILLIONS OF PEOPLE HAVE NO IDEA WHAT THAT 4 WORD COMBINATION REFERS TO ON ANY LEVEL. MILLION. LITERALLY MILLIONS READ THAT 2ND SENTENCE AND SAID FUCK THIS. MILLIONS OF PEOPLE FOUND NO HELP ON THIS LEARN MORE PAGE BECAUSE OF YOUR CHOICE OF WORD.

REQUIRED FOR FIRST PAINT. WHAT THE FUCK WERE YOU THINKING?

Blurp-Codes commented 5 years ago

Hello, I honestly have no idea what the "Required for first Paint" means either, but what I think it basically means, from what I have read, is that you should link your scripts directly into your HTML body.

Okay, so let's say that you have a HTML sheet and an external JavaScript script (JavaScript is basically a language which adds interactivity on a website, such as allowing a user to press a button to perform a certain action.) If you want to add the external JS to the HTML body, have to put a Githubissues.

  • Githubissues is a development platform for aggregating issues.