#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>
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/0107018ff9ae87a0-0b476523-9f72-4989-8abc-6652c6a605e4-000000%40eu-central-1.amazonses.com.

Reply via email to