#19120: readonly_fields poorly documented
--------------------------------------+--------------------
Reporter: EvilDMP | Owner: nobody
Type: Cleanup/optimization | Status: new
Component: Documentation | Version: 1.4
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 0 | UI/UX: 0
--------------------------------------+--------------------
I was stunned to find that I could use a model's method as a
readonly_field in admin. There doesn't seem to be any hint of this in the
documentation - if there is, I have missed it.
It's a really useful bit of functionality, and can give valuable feedback
to the user about the current state of the object they are editing, so I
am quite surprised not to see it mentioned and explained more fully.
Also, although
https://docs.djangoproject.com/en/dev/ref/contrib/admin/#django.contrib.admin.ModelAdmin.fields
says of it "New in Django 1.4: Please see the release notes" there's no
mention of readonly_fields at
https://docs.djangoproject.com/en/dev/releases/1.4/.
Finally,
https://docs.djangoproject.com/en/dev/ref/contrib/admin/#django.contrib.admin.ModelAdmin.readonly_fields
doesn't mention "New in Django 1.4" - should it?
If I have understood this situation correctly, I'm happy to do some work
on the relevant documentation.
--
Ticket URL: <https://code.djangoproject.com/ticket/19120>
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 post to this group, send email to django-updates@googlegroups.com.
To unsubscribe from this group, send email to
django-updates+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.
