title: django-rest-swagger how to document the APIs
body: <p>I am now using DRS for my simple django REST APIs and although its not perfect, it has been a great library so far. But having a few issues</p>
  
  <p>I am using</p>
  
  <pre><code>django-rest-swagger==2.0.3
  </code></pre>
  
  <p>And my api-doc looks like this</p>
  
  <p><a href="https://i.stack.imgur.com/y1VaU.png" rel="nofollow noreferrer"><img src="https://i.stack.imgur.com/y1VaU.png" alt="enter image description here"></a></p>
  
  <p>Issue #1: I can't find a way to add some documentation, I tried putting YAML under my class based viewset action methods, not working. Put docstring under ViewSet class directly, no luck. Then I saw that in the latest DRS release, 2.0 change mentioned YAML docstring has been deprecated. </p>
  
  <p>So how do I provide something like
  1. Endpoint short description
  2. parameter description and probably a sample format</p>
  
  <p>Issue #2: How do I specify which parameter is mandatory. </p>
  
  <p>For example, I have an action in my UserViewSet</p>
  
  <pre><code>    @detail_route(methods=['post'], url_path='set-password')
  @AssertInRequestBody(['password'])
  def set_password(self, request, pk):
      """
      set user password
      """
      user = User.objects.get(pk=pk)
      json_data = get_json_data(request)
      user.set_password(json_data['password'])
      user.save()
      return DefaultResponse(_('Successfully set password for user %s'
                               % user.email), status.HTTP_200_OK)
  </code></pre>
  
  <p>And I want it to be a POST operation and there will be a password in the request body. I can't figure out a way to document that. </p>
  
  <p>This applies to other operations, I guess right now DRS is simply looking at the model definition and serializer definition to determine which parameter is mandatory, which doesn't quite make sense to me. </p>
  
  <p>I feel that DRS should provide some sort of decorators so that we can easily add corresponding documentation to an action method. </p>
  
  <p>But maybe I am wrong, please help if DRS does provide such functionalities. </p>
  
  <p>Thanks, </p>