How to describe parameters in DRF Docs : <p>I'm using Django REST Framework v3.6 built-in interactive documentation <code>django_rest_framework.documentation</code> (<strong>not</strong> <code>django-rest-swagger</code>).</p>

<p>Basically, I'm following <a href="http://www.django-rest-framework.org/topics/documenting-your-api/" rel="noreferrer">the official documentation</a> and use this in my URLset configuration:</p>

<pre><code>from rest_framework.documentation import include_docs_urls

urlpatterns = [
    url(r"^", include_docs_urls(title="My API")),
    ...
]
</code></pre>

<p>Everything seems to work and I get a nice interactive documentation page, but I have a <code>ViewSet</code> with <code>lookup_field = "slug"</code> and one thing about the generated documentation bothers me:</p>

<p><a href="https://i.stack.imgur.com/7ukbh.png" rel="noreferrer"><img src="https://i.stack.imgur.com/7ukbh.png" alt="In &quot;Path parameters&quot;, the description for &quot;slug&quot; parameter is empty"></a></p>

<p>I want to have some useful information it that description, like "an unique permanently-assigned alphanumeric ID" or something among those lines, but can't find any documentation where this data comes from.</p>

<p>There is a workaround but I really don't want to <a href="http://www.django-rest-framework.org/api-guide/schemas/#explicit-schema-definition" rel="noreferrer">define all the schema explicitly</a>. I want to declare my classes with nice docstrings and have docs auto-generated. I've also found an suggestion to put <code>slug -- here goes the description</code> in the docstring but it doesn't seem work - the text just appears with the rest of the Markdown-formatted description.</p>

<p>So... I wonder about two things:</p>

<ol>
<li>(A specific question) Where do I fill this path parameter description?</li>
<li>(More generic version of the same question) What's the best way to learn how schemas are auto-generated from code?</li>
</ol>
