On Jan 17, 2006, at 4:27 PM, oggie rob wrote:
Maybe it's just me...
I doubt it's *just* you...
Why in the world would we want development documentation in the admin
interface? I noticed that the "Documentation" link was added to the
user links section, but none of the users of any real world
application
I can imagine would benefit from that documentation.
In a lot of situations we've been it, we write the backend Django
code for some client, but leave template development up to them.
That's precisely what those views are for, but I also find them
incredibly useful as a quick reference myself.
Even having the "doc/" reference in the admins.url file is pointless,
IMHO, and I don't like putting extra details about implementation in
the user interface. If anything, it could be triggered by DEBUG=True,
or another field in the settings.py file, but I think we should avoid
telling people anything more about the application than is necessary.
The admin interface shouldn't be considered the "user" interface --
it's the interface for trusted content editors. If you can't trust
them with implementation details, it should be trivial to create a
urlconf based on the admin one that leaves out the doc views.
Jacob
