Fix the tags docs to reflect the reality of code

apps/rp/api/serializers.py

@@ -20,10 +20,9 @@ class TagListSerializer(serializers.Field):
 class ArticleSerializer(serializers.ModelSerializer):
     #: List of short tags to describe the article (eg. "Privacy", "Copyright")
     tags = TagListSerializer(help_text="""
-        List of short tags to describe the article (eg."Privacy", "Copyright").
-        Can also be a list of tags or an empty list.
+        List of short tags to describe the article (eg."Privacy, Copyright").
+        Must be a list of tags, coma separated (or an empty string).
         """)
-
     und_score_up = serializers.IntegerField(
             required=False,
             help_text="This is used to increase the vote count by this value")

apps/rp/api/views.py

@@ -25,7 +25,9 @@ class ArticleViewSet(ArticleMixin, viewsets.ModelViewSet):
 
     create:
     Create an article from its URL and inserts it with the
-    status _NEW_.
+    status _NEW_. If the article already exists, it is upvoted
+    by one, and the tags are merged (in case new tags are given
+    to this command).
 
     permissions ```None```