#31690: Document how fuzzy strings are handled by compilemessages
-------------------------------------+-------------------------------------
     Reporter:  sebashwa             |                    Owner:  nobody
         Type:                       |                   Status:  new
  Cleanup/optimization               |
    Component:  Documentation        |                  Version:  3.0
     Severity:  Normal               |               Resolution:
     Keywords:  translation i18n     |             Triage Stage:
  fuzzy compilemessages              |  Unreviewed
  makemessages                       |
    Has patch:  0                    |      Needs documentation:  0
  Needs tests:  0                    |  Patch needs improvement:  0
Easy pickings:  1                    |                    UI/UX:  0
-------------------------------------+-------------------------------------

Comment (by sebashwa):

 Replying to [comment:1 Claude Paroz]:
 > I'm not sure we should explain `gettext` functionality in Django docs.
 The `use_fuzzy` option in https://docs.djangoproject.com/en/stable/ref
 /django-admin/#django-admin-compilemessages should be a good hint to check
 if something doesn't work the way you think.
 > Maybe linking to https://www.gnu.org/software/gettext/manual/html_node
 /Fuzzy-Entries.html in the `use_fuzzy` explanation?

 I agree that this should rather be a short hint and not a fully fledged
 explanation. But I especially would like to mention the fact somewhere in
 the django docs, that those fuzzy translations are automatically generated
 by makemessages sometimes. So maybe a small hint box here:
 https://docs.djangoproject.com/en/3.0/topics/i18n/translation/#message-
 files stating that this can happen (and maybe when it happens) is the way
 to go? Including the link to the docs at gnu.org you are mentioning would
 work fine here as well.

-- 
Ticket URL: <https://code.djangoproject.com/ticket/31690#comment:2>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/066.cf4e7218016fe95cba6db744064aa2ca%40djangoproject.com.

Reply via email to