Docs should assume Python 3 first for __str__/__unicode__ methods

[Tim Graham]

def __unicode__ should be replaced with def __str__ and # On Python 3: def __str__(self): should be replaced with # On Python 2: def __unicode__(self):

[alasdair]

I have done most of this ticket in a branch

​https://github.com/alasdairnicol/django/compare/ticket_21951

I'm unsure what to do about the following docs pages

• ​https://docs.djangoproject.com/en/dev/ref/models/instances/ -- the __str__ method is written for python 2, and returns bytes
• ​https://docs.djangoproject.com/en/dev/releases/1.0-porting-guide/ -- this page mentions replacing __str__ with __unicode__. The page is historic, I suggest leaving it as it is.

[Tim Graham]

1. You could repeat the method twice: first the Python 3 version, then the Python 2 version.
2. I agree.

[alasdair]

1. You could repeat the method twice: first the Python 3 version, then the Python 2 version.

Thanks for the suggestion. I've updated my patch to include examples for Python 3 and 2.

Pull request ​https://github.com/django/django/pull/2258

[Tim Graham <timograham@…>]

In 8aa1efff6d6cb1589a1977f3e68f4c26eb6adc74:

Fixed #21951 -- Updated docs to use str for Python 3

Thanks Tim Graham for the report and recommendations