More method documentation. Needs to find why there's a request body.

apps/rp/api/views.py

@@ -10,6 +10,26 @@ ArticleMixin = get_viewset_transition_actions_mixin(Article)
 
 
 class ArticleViewSet(ArticleMixin, viewsets.ModelViewSet):
+    """
+    list:
+    List all known articles in database.
+
+    create:
+    Create an article from its URL and inserts it with the
+    status NEW
+
+    read:
+    Get a specific article by id
+
+    update:
+    Change the content of an article
+
+    partial_update:
+    Change only some fields of an article
+
+    downvote:
+    Decrement the score of an article by one.
+    """
     queryset = Article.objects.all()
     serializer_class = ArticleSerializer
 

apps/rp/models.py

@@ -91,7 +91,7 @@ class Article(VoteMixin):
     #: priority: True if article have priority
     priority = models.BooleanField(default=False)
 
-    #: List of short tags to describe the article (eg. "Privacy", "Copyright")
+    #: Comma separated list of short tags to describe the article (eg: "Privacy", "Copyright").
     tags = TaggableManager(blank=True)
 
     class Meta: