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.

Sign up for GitHub

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

Style updates for etc., YouTube, em-dash #4

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Style updates for etc., YouTube, em-dash #4

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions source/intro.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,8 +65,8 @@ Searching

Since "go" is such a common English word, it is completely useless as a search
term when googling. Instead search for "golang". It is standard practice in
the community that all Go-related blog posts, Github repos, tweets, job
postings, etc be tagged with "golang".
the community that all Go-related blog posts, GitHub repos, tweets, job
postings, etc., be tagged with "golang".
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use of a period after "etc" is a stylistic matter of some contention. In the English dialects I speak - Rustbelt American and Silicon Valley American - as well as in standard British usage, the period is considered superfluous.

Please remove this change.



Who's Using Go?
Expand All @@ -76,7 +76,7 @@ Google
Home of the Go authors and core team, signifiant parts of the Google
infrastructure are thought to be written in Go. The company however does not
publicly disclose which Google services are written in which languages.
Youtube is known to be powered by Vitess_, an open source, massively scalable
YouTube is known to be powered by Vitess_, an open source, massively scalable
database multiplexing layer written in Go.

Heroku
Expand Down Expand Up @@ -127,10 +127,10 @@ Requirements

Command line examples were written on an `Ubuntu`_ 12.10 desktop environment.
Everything we do in this book can also be done on other flavors of Linux, on Mac
OSX - probably even on Windows.
OSX—probably even on Windows.
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not a fan of the em-dash in plain text files. Also not a fan of removing the spaces - it makes the sentence harder to read.

Please remove this change.


In addition to Go language basics, this book also covers cloud_ deployment and
`continuous integration`_ tools & techniques popular in the Go community. You
`continuous integration`_ tools and techniques popular in the Go community. You
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I prefer the ampersand.

Please remove this change.

will need free accounts on the following services:

* Github_
Expand Down