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

Capitalize Web in description. #304

Closed
wants to merge 1 commit into
base: master
from

Conversation

Projects
None yet
5 participants
@rhroyston
Copy link

rhroyston commented Feb 17, 2017

Web as in World Wide Web, not web.

Capitalize Web
Web as in World Wide Web, not web.
@googlebot

This comment has been minimized.

Copy link

googlebot commented Feb 17, 2017

Thanks for your pull request. It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

📝 Please visit https://cla.developers.google.com/ to sign.

Once you've signed, please reply here (e.g. I signed it!) and we'll verify. Thanks.


  • If you've already signed a CLA, it's possible we don't have your GitHub username or you're using a different email address. Check your existing CLA data and verify that your email is set on your git commits.
  • If you signed the CLA as a corporation, please let us know the company's name.
@rhroyston

This comment has been minimized.

Copy link

rhroyston commented Feb 17, 2017

cla executed

@googlebot

This comment has been minimized.

Copy link

googlebot commented Feb 17, 2017

CLAs look good, thanks!

@traviskaufman

This comment has been minimized.

Copy link
Contributor

traviskaufman commented Feb 21, 2017

Our product guidelines delineate the use of "web", not "Web".

@rhroyston

This comment has been minimized.

Copy link

rhroyston commented Mar 1, 2017

You might circle back with the product guidelines team and let them know that web is always capitalized and refers to the World Wide Web. There is no lowercase web related to the Web.

@Garbee

This comment has been minimized.

Copy link
Contributor

Garbee commented Mar 1, 2017

The web is such a synonymous term at this point it really doesn't matter how it is capitalized. Everyone still understands exactly what it means either way.

Although technically, "web" is the recommended Chicago style unless you are specifically saying "World Wide Web" as that is a proper noun in whole. This is just one provider of guidelines though, there could be numerous other contradictory guidelines around the web from people trying to normalize the English language. Clear enough though that "web" vs "Web" should not be a major concern for the project.

Thank you.

@rhroyston

This comment has been minimized.

Copy link

rhroyston commented Mar 1, 2017

@amsheehan

This comment has been minimized.

Copy link
Collaborator

amsheehan commented Mar 1, 2017

That link is not a style guide from W3C. Rather, it is a FAQ in which W3C casually refers to the web as "the Web", but does not explicitly give an opinion on the semantics of the use of capitalization when referring to "the web". In our case, since the instances of "web" we use in the docs are meant to communicate to the user what the target platform of the library is, we can safely assume that the user knows we are referring to the "the Web" [sic].

Further, the AP style book, while not explicitly naming the web in their latest issue, do recommend that the word "internet" be lower case—and in 2010 also changed "Web site" to "website".

Since the W3C does not give specific guidance on the issue, and the Chicago manual of style—as well as the AP style book (tangentially) do, we will be sticking with "the web"

@Garbee

This comment has been minimized.

Copy link
Contributor

Garbee commented Mar 1, 2017

The W3C doesn't "trump" anyone in any case. They do not dictate the English language or influence it in any way. Further pulling a W3C post from 2002 and comparing it to one of the most widely used style guides in the US that was updated in 2010 is trying to say nothing ever changes and the W3C always does things correctly that last an eternity.

The capitalization is proper as lowercase. Web in itself is not a proper noun, therefore it should not be capitalized. That's standard English grammatical structure.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment