[Django] #12193: Add details to the 18n documentation for translation of model classes

[Django]

#12193: Add details to the 18n documentation for translation of model classes
------------------------------------------+---------------------------------
Reporter: maxime.p...@bulix.org | Owner: nobody
Status: new | Milestone:
Component: Documentation | Version: 1.1
Keywords: i18n | Stage: Unreviewed
Has_patch: 1 | Needs_docs: 0
Needs_tests: 0 | Needs_better_patch: 0
------------------------------------------+---------------------------------
While working on the internationalization of a Django application
recently, I had a hard time finding how to translate a few things used in
model classes : relations and model methods, when used for columns or
fields in the Django admin site.

I finally found the solutions from some random code snippet on the web,
but I think this really belongs to Django's excellent documentation, so
you'll find attached a patch to add a few details on how this is done.

I know there's an i18n documentation refactoring going on in #10260. If my
patch needs to be reworked on top of that refactoring once it's checked
in, please let me know.

--
Ticket URL: <http://code.djangoproject.com/ticket/12193>
Django <http://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

[Django]

#12193: Add details to the i18n documentation for translation of model classes
(relations and methods)
-------------------------------------------------+--------------------------

Reporter: maxime.p...@bulix.org | Owner: nobody
Status: new | Milestone:
Component: Documentation | Version: 1.1

Resolution: | Keywords: i18n

Stage: Unreviewed | Has_patch: 1
Needs_docs: 0 | Needs_tests: 0
Needs_better_patch: 0 |

-------------------------------------------------+--------------------------
Changes (by maxime.p...@bulix.org):

* summary: Add details to the 18n documentation for translation of model
classes => Add details to the i18n

documentation for translation of model classes

(relations and methods)

Comment:

Fixing typo in bug summary.

--
Ticket URL: <http://code.djangoproject.com/ticket/12193#comment:1>

[Django]

#12193: Add details to the i18n documentation for translation of model classes
(relations and methods)
-------------------------------------------------+--------------------------
Reporter: maxime.p...@bulix.org | Owner: nobody
Status: new | Milestone: 1.2

Component: Documentation | Version: 1.1
Resolution: | Keywords: i18n

Stage: Accepted | Has_patch: 1
Needs_docs: 0 | Needs_tests: 0
Needs_better_patch: 1 |
-------------------------------------------------+--------------------------
Changes (by russellm):

* needs_better_patch: 0 => 1
* stage: Unreviewed => Accepted
* milestone: => 1.2

Comment:

Will need to be updated to be integrated into the changes for #10260, but
otherwise seems reasonable.

--
Ticket URL: <http://code.djangoproject.com/ticket/12193#comment:2>

[Django]

#12193: Add details to the i18n documentation for translation of model classes
(relations and methods)
-------------------------------------------------+--------------------------
Reporter: maxime.p...@bulix.org | Owner: nobody

Status: new | Milestone: 1.2
Component: Documentation | Version: 1.1
Resolution: | Keywords: i18n

Stage: Accepted | Has_patch: 1

Needs_docs: 0 | Needs_tests: 0
Needs_better_patch: 0 |

-------------------------------------------------+--------------------------
Changes (by ramiro):

* needs_better_patch: 1 => 0

--
Ticket URL: <http://code.djangoproject.com/ticket/12193#comment:3>

[Django]

#12193: Add details to the i18n documentation for translation of model classes
(relations and methods)
-------------------------------------------------+--------------------------

Reporter: maxime.p...@bulix.org | Owner: nobody
Status: new | Milestone:
Component: Documentation | Version: 1.1

Resolution: | Keywords: i18n
Stage: Accepted | Has_patch: 1

Needs_docs: 0 | Needs_tests: 0
Needs_better_patch: 0 |

-------------------------------------------------+--------------------------
Changes (by ubernostrum):

* milestone: 1.2 =>

Comment:

This isn't critical to 1.2; we can always go back and improve
documentation as needed, but attention right now should focus on actual
bugs.

--
Ticket URL: <http://code.djangoproject.com/ticket/12193#comment:4>