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

Update Python versions in dev docs #898

Merged
merged 1 commit into from Aug 21, 2022
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
20 changes: 2 additions & 18 deletions docs/dev.rst
Expand Up @@ -30,34 +30,18 @@ Python Versions

At the moment the following Python versions should be supported:

* Python 2.7
* Python 3.4 and up
* PyPy tracking 2.7 and 3.2 and up

While PyPy does not currently support 3.3, it does support traditional
unicode literals which simplifies the entire situation tremendously.

Documentation must build on Python 2, Python 3 support for the
documentation is an optional goal. Code examples in the docs preferably
are written in a style that makes them work on both 2.x and 3.x with
preference to the former.
* Python 3.6 and up
* PyPy 3.7 and up

Unicode
-------

Unicode is a big deal in Babel. Here is how the rules are set up:

* internally everything is unicode that makes sense to have as unicode.
The exception to this rule are things which on Python 2 traditionally
have been bytes. For example file names on Python 2 should be treated
as bytes wherever possible.
* Encode / decode at boundaries explicitly. Never assume an encoding in
a way it cannot be overridden. utf-8 should be generally considered
the default encoding.
* Dot not use ``unicode_literals``, instead use the ``u''`` string
syntax. The reason for this is that the former introduces countless
of unicode problems by accidentally upgrading strings to unicode which
should not be. (docstrings for instance).

Dates and Timezones
-------------------
Expand Down