Skip to content

Revise 'consenting adult' verbiage #524

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

Merged
merged 1 commit into from
Mar 9, 2015
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/writing/style.rst
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ Arguments can be passed to functions in four different ways.
1. **Positional arguments** are mandatory and have no default values. They are
the simplest form of arguments and they can be used for the few function
arguments that are fully part of the function's meaning and their order is
natural. For instance, in ``send(message, recipient)`` or ``point(x, y)``
natural. For instance, in ``send(message, recipient)`` or ``point(x, y)``
the user of the function has no difficulty remembering that those two
functions require two arguments, and in which order.

Expand Down Expand Up @@ -190,15 +190,15 @@ them is very important.
Like a kung fu master, a Pythonista knows how to kill with a single finger, and
never to actually do it.

We are all consenting adults
We are all responsible users
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

As seen above, Python allows many tricks, and some of them are potentially
dangerous. A good example is that any client code can override an object's
properties and methods: there is no "private" keyword in Python. This
philosophy, very different from highly defensive languages like Java, which
give a lot of mechanisms to prevent any misuse, is expressed by the saying: "We
are all consenting adults".
are all responsible users".

This doesn't mean that, for example, no properties are considered private, and
that no proper encapsulation is possible in Python. Rather, instead of relying
Expand Down