Skip to content

Suddenly confusing passage on page 169, 17.11 #92

Open
@ghost

Description

"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."

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

      Development

      No branches or pull requests

        Participants

        No participants

        Issue actions

          Suddenly confusing passage on page 169, 17.11 · Issue #92 · AllenDowney/ThinkPython2