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

tour: Reader has method not func #196

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

crisman
Copy link
Contributor

@crisman crisman commented Feb 24, 2023

Interfaces do not define func as in the current text of "Readers"
("/tour/methods/21"). The interface specifies a list of methods, just Read() in
this case. It is confusing to say "interface has a Read method" and then show a
code line defining what would be a method on a type that impliments the
interface.

Changed the article text to follow the pattern of "Stringers"
("/tour/methods/17") which shows the interface definition in the code block. In
following this pattern I moved the code just below that text about the package
io and its io.Reader interface.

Fixes golang/tour#1450

Change is in two commits to try to avoid stomping on the blame log for the line between "The Go standard library contains...". Not sure this was successful, useful, or needed.

Interfaces do not define func as in the current text of "Readers"
("/tour/methods/21"). The interface specifies a list of methods, just Read() in
this case. It is confusing to say "interface has a Read method" and then show a
code line defining what would be a method on a type that impliments the
interface.

Changed the article text to follow the pattern of "Stringers"
("/tour/methods/17") which shows the interface definition in the code block. In
following this pattern I moved the code just below that text about the package
io and its io.Reader interface.

part 1/2
Interfaces do not define func as in the current text of "Readers"
("/tour/methods/21"). The interface specifies a list of methods, just Read() in
this case. It is confusing to say "interface has a Read method" and then show a
code line defining what would be a method on a type that impliments the
interface.

Changed the article text to follow the pattern of "Stringers"
("/tour/methods/17") which shows the interface definition in the code block. In
following this pattern I moved the code just below that text about the package
io and its io.Reader interface.

part 2/2

Fixes golang/tour#1450
@gopherbot
Copy link
Contributor

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

Please visit https://go-review.googlesource.com/c/website/+/471176 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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Odd code with an interface with a func definition
2 participants