New GitHub issue #119016 from deuberger:<br>

<hr>

<pre>
# Documentation

>From https://docs.python.org/3/tutorial/classes.html#instance-objects:

```
The other kind of instance attribute reference is a method. A method is a function that “belongs to” an object. (In Python, the term method is not unique to class instances: other object types can have methods as well. For example, list objects have methods called append, insert, remove, sort, and so on. However, in the following discussion, we’ll use the term method exclusively to mean methods of class instance objects, unless explicitly stated otherwise.)
```

>From the user's perspective, a list is a class in Python 3.  It may be implemented under the hood using some special construct, but in all the documentation and to the user, it is still a class. So an a list object is a class instance for all intents and purposes even if it's really not under the hood.

I suggest reworking this paragraph to clarify whatever it's trying to communicate or deleting it except the first 2 sentences. 

A potential reworked version is below, but I'm not sure it wouldn't still be confusing to someone new.

```
The other kind of instance attribute reference is a method. A method is a function that “belongs to” an object. (Note that technically, there are different types of methods in python - see https://docs.python.org/3/library/stdtypes.html#methods for more details. However, in the following discussion, we’ll use the term method exclusively to mean methods of class instance objects, unless explicitly stated otherwise.)
```

Note that part of the confusion might be because the tutorial doesn't really explain about bound methods. Note that the following section 9.3.4 mentions a method being "bound" without the terminology ever being explained.

Is the distinction between built-in and instance methods even necessary at this point especially in higher level docs like the tutorial?
</pre>

<hr>

<a href="https://github.com/python/cpython/issues/119016">View on GitHub</a>
<p>Labels: docs</p>
<p>Assignee: </p>