better error clear wording

mkdocs/docs/advanced.md

@@ -119,7 +119,7 @@ Then you can restart the container and the migration will run again. If your err
 
 ## Manual yt-dlp update
 !!! warning 
-	Doing this is **very likely** going to break things for you. You will want to try this out on a testing instance first. There are have regularly been subtle changes in the yt-dlp API, so only do this if you know how to debug this project by yourself, but obviously share your fixes so any problems can be dealt with before release.
+	Doing this is **very likely** going to break things for you. You will want to try this out on a testing instance first. Regularly there have been subtle changes in the yt-dlp API, so only do this if you know how to debug this project by yourself, but obviously share your fixes so any problems can be dealt with before release.
 This project strives for timely updates when yt-dlp makes a new release, but sometimes ideals meet reality. Also, sometimes yt-dlp has a fix published, but not yet released.
 
 **Build your own image**: Update the version in `requirements.txt` and rebuild the image from `Dockerfile`. This will use your own image, even on container rebuild.
@@ -145,18 +145,32 @@ pip install \
 This is obviously particularly likely to create problems. Also note that the `--version` command will only show the latest regular release, not a nightly version mentioned.
 
 ## Erase errors from download queue
-Sometimes the download queue might have some videos that have errored due to rate limits or other issues during the download process. Videos that have errors won't be retried in a future download queue re-run unless you individually click "Download now" for each individual video or until the container is fully restarted. In order to bulk clear the errors from the download queue without restarting the container, you need to execute the following command from within the TA container:
+Sometimes videos will fail to download. That can be because of expected errors:
+
+- A video is no longer available for download.
+
+That is not recoverable.
+
+Other kind of errors *are* recoverable, for example:
+
+- You got temporarily rate limited.
+- Your internet connection dropped out.
+
+Failed downloads won't get retried again as they require your intervention. You can click on **Download Now** on a video in the queue to verify, if a video became available again.
+
+If you know that all errors are resolved you can bulk clear. Run this from within the TA container:
+
 ???+ bug "Erase Errors"
 	```bash
 	curl -X POST "$ES_URL/ta_download/_update_by_query?pretty" -u elastic:$ELASTIC_PASSWORD -H 'Content-Type: application/json' -d'
 	{
-	"script": {
-		"source": "ctx._source.message = null",
-		"lang": "painless"
-	},
-	"query": {
-		"match_all": {}
-	}
+		"script": {
+			"source": "ctx._source.message = null",
+			"lang": "painless"
+		},
+		"query": {
+			"match_all": {}
+		}
 	}
 	'
 	```