#35506: Rewrite confusing "URLconf" references in the Tutorial Part 1
-------------------------------------+-------------------------------------
Reporter: Lucas Oliveira | Owner: Lucas
Type: | Oliveira
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: tutorial | Triage Stage: Accepted
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Natalia Bidart):
* keywords: documentation, tutorial, rewrite => tutorial
* stage: Unreviewed => Accepted
Comment:
Thank you Lucas for the report and Tim for the initial thoughts.
I generally agree that minimizing translation changes has high priority,
but in this particular case, where inexperienced users are reading the
tutorial for the first time (and even this is the first page), I think
that some in-place clarification is needed. I'm accepting the ticket on
that basis and also because:
1. When following the [
https://diataxis.fr/ diátaxis] approach to writing
docs, a tutorial should be the smoother and simplest learning journey for
someone that is not familiar with the topic being presented, so jumps to
glossaries should be avoided.
2. After a very recent workshop from Daniele at DjangoCon Europe, the
Django tutorial was reviewed to spot parts that would benefit from some
improvements. This means that translation updates will be required in
these files nevertheless.
--
Ticket URL: <
https://code.djangoproject.com/ticket/35506#comment:3>