id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
19062	reST Markup not supported for docstrings on the model detail.	Mr_Dave	nobody	"reST Markup is supported when rendering docstrings as documentation in the admindocs app. According to the list of supported [https://docs.djangoproject.com/en/dev/ref/contrib/admin/admindocs/ Django Component reST roles], markup such as 
{{{
:model:`appname.ModelName`
:tag:`tagname`
}}}
should be rendered in admindocs as a hyperlink to the admindoc page for the specified component.

It appears that this isn't supported for docstrings that are rendered as model descriptions. From the  [https://github.com/django/django/blob/master/django/contrib/admindocs/views.py view]:


{{{
    return render_to_response('admin_doc/model_detail.html', {
        'root_path': urlresolvers.reverse('admin:index'),
        'name': '%s.%s' % (opts.app_label, opts.object_name),
        'summary': _(""Fields on %s objects"") % opts.object_name,
        'description': model.__doc__,
        'fields': fields,
    }, context_instance=RequestContext(request))
}}}

Instead of returning `model.__doc__` as `description`, this needs to parsed for reST.

{{{
    model_description = utils.parse_rst(model.__doc__, 'model', _('model:') + opts.module_name)
}}}"	Bug	closed	contrib.admindocs	1.4	Normal	duplicate			Unreviewed	0	0	0	0	0	0