#17319 closed Cleanup/optimization (fixed)
Internationalization documentation
Reported by: | Owned by: | nobody | |
---|---|---|---|
Component: | Documentation | Version: | 1.3 |
Severity: | Normal | Keywords: | internationalization |
Cc: | Triage Stage: | Ready for checkin | |
Has patch: | yes | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | no |
Easy pickings: | yes | UI/UX: | no |
Description
Ok, you won't believe this one: neither do I
(and I've seen a lot of mistakes done by myself during my programming years --- I'm not such an experienced programmer, but I try)
I'm so involved in internationalization, that I'm always reading online questions about this topic, trying to learn something more, and to help other people in the (rare) fortunate case that I know how to help them.
In several communities/forums/etc I've stumbled on several people posting tickets (with titles like "Django Internationalization not working" )
where the error was simply that they're copy-pasting the code in this documentation part
https://docs.djangoproject.com/en/1.3/topics/i18n/internationalization/#the-set-language-redirect-view
without noticing that in this line
<input name="next" type="hidden" value="/next/page/" />
The "/next/page/
" string is just an example.
(They actually used "/next/page/"
as a value)
Ok, things likte this can happen to everyone, we know that.
At the beginning I thought that it was because the askers were newbies, but I've seen this issue also from more advanced people...
The reason could be maybe distraction, maybe faith... I don't know...
But the fact is that too many programmers made the same mistake,
so maybe this part of the documentation could be improved in someway
(I don't know... maybe a simple change like "/next/page/path/
" or "next_page
" or "desired_next_page
" could help)
Thank you
Anna Dolma Alonso
Biodiversity Informatics
Fundación Charles Darwin
Galapagos
Attachments (3)
Change History (9)
comment:1 by , 13 years ago
Triage Stage: | Unreviewed → Accepted |
---|
by , 13 years ago
Attachment: | django-17319-translation-docs.diff added |
---|
comment:2 by , 13 years ago
Oops, we just has a concurrency issue on this ticket :) Attaching my own version.
by , 13 years ago
Attachment: | 17319.patch added |
---|
by , 13 years ago
Attachment: | django-17319-update-translation-docs-2.patch added |
---|
comment:4 by , 13 years ago
Triage Stage: | Accepted → Ready for checkin |
---|
Please don't set the "has patch" flag without actually providing the patch as attachment!
A little nudge that the HTML uses an example url could not hurt; creating a patch for it.