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

Suddenly confusing passage on page 169, 17.11 #92

Open
Bob-Builderson opened this issue Apr 18, 2022 · 0 comments
Open

Suddenly confusing passage on page 169, 17.11 #92

Bob-Builderson opened this issue Apr 18, 2022 · 0 comments

Comments

@Bob-Builderson
Copy link

Bob-Builderson commented Apr 18, 2022

"A design principle that helps achieve that goal is to keep interfaces separate from implementations. For objects, that means that the methods a class provides should not depend on how the attributes are represented."

Your earlier definitions:
Chapter 4
"interface: A description of how to use a function, including the name and descriptions of the arguments and return value."
Chapter 11
"implementation: A way of performing a computation."

So rewritten with your definitions:
A design principle that helps achieve that goal is to keep descriptions of how to use functions, (including the names and descriptions of the arguments and return values) separate from ways of preforming a computation.

So... I should keep my descriptions of how a function works (like comments?) separate from the ways I preform a computation... (like the actual code...)??

Again, maybe it's just me being too dumb, but it sounds more like: you want to use a cutesy phrase that has some meaning in computer science circles- in an introductory computer science textbook.

I'm fine with introducing jargon (like you have done excellently throughout the rest of the book) but I don't like it when you introduce it without an explanation.

Here's my own cute phrase for what I mean: "Jargon without explanation is frustration."

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

No branches or pull requests

1 participant