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
30607	How to use Django specific markup in the docstrings.	Anuj Sharma	nobody	"I am using Sphinx to generate documentation from the docstrings defined in the modes, view, etc files.

At a few places, I have used Django specific markup for creating reference link. Same is documented in the [writing-documentation](https://docs.djangoproject.com/en/dev/internals/contributing/writing-documentation/#django-specific-markup)

Ex.

{{{
The length is defined in the :setting:`URL_ID_LENGTH`
}}}

But while generating the documentation using 
{{{
make html,
}}}
 it gives an error as


{{{
:docstring of app.models.Class.function:4: WARNING: Unknown interpreted text role ""setting"".
}}}


How to use the Django specific markups? This should be added to the documentation as well.

Here is an issue on StackOverflow: https://stackoverflow.com/q/56803854/3719167"	Cleanup/optimization	new	Documentation	2.2	Normal		writing-documentation, Django-specific-markup		Unreviewed	0	0	0	0	0	0