forked from pythontsunami/teaching
-
Notifications
You must be signed in to change notification settings - Fork 14
Open
Description
Should we document object methods or module functions using obj.method (module.function) or obj.method() (module.function()).
I prefer the former, Rita used the ladder.
| notatin | arguments |
|---|---|
obj.methodmodule.function |
as function are object itself (first-class citizens), they can be assigned. They are callable (or callable()!) which describes them. |
obj.method() module.function() |
Suggests directly that they are callable and distinguishes them from other attributes. |
I have seen both in the official documentation. I just think it will be good to be consistent.
Any opinion or good reference to elaborate the issue?
Metadata
Metadata
Assignees
Labels
No labels