Improve GraphQL documentation and cleanup API

Signed-off-by: Thomas Citharel <tcit@tcit.fr>

lib/graphql/schema/events/feed_token.ex

@@ -10,7 +10,12 @@ defmodule Mobilizon.GraphQL.Schema.Events.FeedTokenType do
   alias Mobilizon.{Actors, Users}
   alias Mobilizon.GraphQL.Resolvers.FeedToken
 
-  @desc "Represents a participant to an event"
+  @desc """
+  Represents a feed token
+
+  Feed tokens are tokens that are used to provide access to private feeds such as WebCal feed for all of your user's events,
+  or an Atom feed for just a profile.
+  """
   object :feed_token do
     field(
       :actor,
@@ -31,21 +36,21 @@ defmodule Mobilizon.GraphQL.Schema.Events.FeedTokenType do
 
   @desc "Represents a deleted feed_token"
   object :deleted_feed_token do
-    field(:user, :deleted_object)
-    field(:actor, :deleted_object)
+    field(:user, :deleted_object, description: "The user that owned the deleted feed token")
+    field(:actor, :deleted_object, description: "The actor that owned the deleted feed token")
   end
 
   object :feed_token_mutations do
     @desc "Create a Feed Token"
     field :create_feed_token, :feed_token do
-      arg(:actor_id, :id)
+      arg(:actor_id, :id, description: "The actor ID for the feed token")
 
       resolve(&FeedToken.create_feed_token/3)
     end
 
     @desc "Delete a feed token"
     field :delete_feed_token, :deleted_feed_token do
-      arg(:token, non_null(:string))
+      arg(:token, non_null(:string), description: "The token to delete")
 
       resolve(&FeedToken.delete_feed_token/3)
     end