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

Fix link and improve wording #38

Closed
wants to merge 1 commit into from
Closed

Fix link and improve wording #38

wants to merge 1 commit into from

Conversation

simondrake
Copy link
Contributor

  • Fix the time.After link so it shows properly
  • Improve the wording describing the Query function, so it's clearer to readers.

@googlebot
Copy link

Thanks for your pull request. It looks like this may be your first contribution to a Google open source project (if not, look below for help). 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 (or fixed any issues), please reply here with @googlebot I signed it! and we'll verify it.


What to do if you already signed the CLA

Individual signers
Corporate signers

ℹ️ Googlers: Go here for more info.

@simondrake
Copy link
Contributor Author

@googlebot I signed it!

@googlebot
Copy link

CLAs look good, thanks!

ℹ️ Googlers: Go here for more info.

@googlebot googlebot added cla: yes and removed cla: no labels Jun 1, 2020
@gopherbot
Copy link

This PR (HEAD: 1e46612) has been imported to Gerrit for code review.

Please visit https://go-review.googlesource.com/c/blog/+/235897 to see it.

Tip: You can toggle comments from me using the comments slash command (e.g. /comments off)
See the Wiki page for more info

@gopherbot
Copy link

Message from Gobot Gobot:

Patch Set 1:

Congratulations on opening your first change. Thank you for your contribution!

Next steps:
Within the next week or so, a maintainer will review your change and provide
feedback. See https://golang.org/doc/contribute.html#review for more info and
tips to get your patch through code review.

Most changes in the Go project go through a few rounds of revision. This can be
surprising to people new to the project. The careful, iterative review process
is our way of helping mentor contributors and ensuring that their contributions
have a lasting impact.

During May-July and Nov-Jan the Go project is in a code freeze, during which
little code gets reviewed or merged. If a reviewer responds with a comment like
R=go1.11, it means that this CL will be reviewed as part of the next development
cycle. See https://golang.org/s/release for more details.


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

Message from Ian Lance Taylor:

Patch Set 1:

(2 comments)


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

Message from Bryan C. Mills:

Patch Set 1:

(1 comment)


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

Message from Bryan C. Mills:

Patch Set 1:

(1 comment)


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

Message from si drake:

Patch Set 1:

How about:

In this example, the closure first computes the result of the call to DoQuery,
then attempts to send it without blocking
by wrapping the send in a select statement with a default case.

After rewriting it a couple of times, I came up with the following. It's slightly different from your recommendation, but uses the same sort of language. Thoughts?

In this example, the closure performs a non-blocking operation, by computing the result of the call to DoQuery,
and attempting to send the result on the channel ch in a select statement, with a default case.


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

Message from si drake:

Patch Set 1:

I've updated the time.After link to be [time.After] as suggested, and it works/looks fine locally. Once we've got the other wording finalised, I'll push an update.

Commit messages has also been amended as per the link sent.


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

Message from si drake:

Patch Set 1:

(3 comments)

Do I need to do something to have this re-reviewed, after addressing the comments, or is it just a waiting game?


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

Message from Ian Lance Taylor:

Patch Set 1:

I'm not seeing your changes. Are you sure that you pushed them? Thanks.


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

This PR (HEAD: ce40f1a) has been imported to Gerrit for code review.

Please visit https://go-review.googlesource.com/c/blog/+/235897 to see it.

Tip: You can toggle comments from me using the comments slash command (e.g. /comments off)
See the Wiki page for more info

@gopherbot
Copy link

Message from si drake:

Patch Set 1:

I'm not seeing your changes. Are you sure that you pushed them? Thanks.

Not sure what happened there, but it doesn't look like I comitted the changes (or I somehow rebased them out).

I've updated again and comitted. Let me know if there are any further changes to make.


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

Message from Ian Lance Taylor:

Patch Set 2:

(1 comment)


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

This PR (HEAD: 8ae6098) has been imported to Gerrit for code review.

Please visit https://go-review.googlesource.com/c/blog/+/235897 to see it.

Tip: You can toggle comments from me using the comments slash command (e.g. /comments off)
See the Wiki page for more info

@gopherbot
Copy link

This PR (HEAD: 1103f71) has been imported to Gerrit for code review.

Please visit https://go-review.googlesource.com/c/blog/+/235897 to see it.

Tip: You can toggle comments from me using the comments slash command (e.g. /comments off)
See the Wiki page for more info

@gopherbot
Copy link

This PR (HEAD: 5216487) has been imported to Gerrit for code review.

Please visit https://go-review.googlesource.com/c/blog/+/235897 to see it.

Tip: You can toggle comments from me using the comments slash command (e.g. /comments off)
See the Wiki page for more info

@gopherbot
Copy link

Message from si drake:

Patch Set 5:

(1 comment)

Should be good for another review at your leisure.


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

Message from Bryan C. Mills:

Patch Set 5:

(1 comment)


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

Message from si drake:

Patch Set 5:

I just did a little bit of research afer Bryan's last comment and it looks like my understanding, of what that block of code does, was wrong.

Without dragging this on, I think I might be able to add some extra context to this paragraph for future readers so they don't have the same misunderstanding.

How does that sound? Do you normally have some sort of timeframe for these?


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

- Fix the `time.After` link so it shows properly
- Improve the wording describing the `Query` function, so it's clearer to readers.
@gopherbot
Copy link

This PR (HEAD: 82fd5c2) has been imported to Gerrit for code review.

Please visit https://go-review.googlesource.com/c/blog/+/235897 to see it.

Tip: You can toggle comments from me using the comments slash command (e.g. /comments off)
See the Wiki page for more info

@gopherbot
Copy link

Message from si drake:

Patch Set 5:

OK I've pushed another patch.

It's actually VERY similar to Bryan's, as I took some of the wording, but I think the reference to the result not being immediately available from DoQuery clears up the confusion.

Also perfectly happy to just go ahead with Bryan's last suggestion in it's entirety.


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

Message from Ian Lance Taylor:

Patch Set 6:

(2 comments)


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

Message from Go Bot:

Patch Set 1:

Congratulations on opening your first change. Thank you for your contribution!

Next steps:
Within the next week or so, a maintainer will review your change and provide
feedback. See https://golang.org/doc/contribute.html#review for more info and
tips to get your patch through code review.

Most changes in the Go project go through a few rounds of revision. This can be
surprising to people new to the project. The careful, iterative review process
is our way of helping mentor contributors and ensuring that their contributions
have a lasting impact.

During May-July and Nov-Jan the Go project is in a code freeze, during which
little code gets reviewed or merged. If a reviewer responds with a comment like
R=go1.11, it means that this CL will be reviewed as part of the next development
cycle. See https://golang.org/s/release for more details.


Please don’t reply on this GitHub thread. Visit golang.org/cl/235897.
After addressing review feedback, remember to publish your drafts!

@gopherbot
Copy link

This PR is being closed because golang.org/cl/235897 has been abandoned.

Closing because the content of x/blog moved to x/website (see CL 324270). If this change still applies, it'd need to be re-sent it to x/website. Thanks.

@gopherbot gopherbot closed this Mar 3, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants