From 83a843befe1937dc67a02f43586ceaebee4d8fb7 Mon Sep 17 00:00:00 2001
From: Lee Peuker <lee.peuker@protonmail.com>
Date: Thu, 14 Sep 2023 19:58:34 +0200
Subject: [PATCH] Improve api docs

---
 docs/openapi.json | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/docs/openapi.json b/docs/openapi.json
index d1dbd1ff..91bf7a05 100644
--- a/docs/openapi.json
+++ b/docs/openapi.json
@@ -11,7 +11,8 @@
         "tags": [
           "History"
         ],
-        "summary": "Get watch dates from user history (sorted by most recently watched)",
+        "summary": "Get played movies with watch dates of user",
+        "description": "Get all played movies with watch dates set. Sorted by most recently watch dates on default.",
         "parameters": [
           {
             "name": "username",
@@ -104,7 +105,8 @@
         "tags": [
           "History"
         ],
-        "summary": "Add watch dates to user history",
+        "summary": "Add movie play with watch date set to user",
+        "description": "Create or update the provided watch dates for the specified movies. A date for plays is required.",
         "parameters": [
           {
             "name": "username",
@@ -163,7 +165,8 @@
         "tags": [
           "History"
         ],
-        "summary": "Replace watch dates in user history",
+        "summary": "Replace movie play with watch date set for user",
+        "description": "Create or replace the provided watch dates for the specified movies. A date for plays is required.",
         "parameters": [
           {
             "name": "username",
@@ -222,7 +225,8 @@
         "tags": [
           "History"
         ],
-        "summary": "Delete watch dates from user history",
+        "summary": "Delete movie watch dates from user history",
+        "description": "Delete all watch dates of specified movies if no specific watch dates are provided. A date for plays is required.",
         "parameters": [
           {
             "name": "username",
@@ -277,7 +281,8 @@
         "tags": [
           "Watchlist"
         ],
-        "summary": "Get movies from user watchlist (sorted by most recently added)",
+        "summary": "Get movies in watchlist of user",
+        "description": "Get all movies on the user watchlist. Sorted by most recently added on default.",
         "parameters": [
           {
             "name": "username",
@@ -410,7 +415,7 @@
         "tags": [
           "Watchlist"
         ],
-        "summary": "Add movies to user watchlist",
+        "summary": "Add movie to watchlist of user",
         "parameters": [
           {
             "name": "username",
@@ -460,7 +465,7 @@
         "tags": [
           "Watchlist"
         ],
-        "summary": "Delete movies from user watchlist",
+        "summary": "Delete movie from watchlist of user",
         "parameters": [
           {
             "name": "username",