diff --git a/docs/config/operations.md b/docs/config/operations.md
index c5917022..ed06c5f5 100644
--- a/docs/config/operations.md
+++ b/docs/config/operations.md
@@ -157,6 +157,10 @@ You can create individual blocks of operations by using a list under `operations
**Accepted Values:** Source or List of sources to use in that order
+ ???+ tip "Note on `mdb` sources"
+
+ MDBList is not a live reflection of third-party sites such as CommonSense and Trakt. The data on MDBList is often days, weeks and months out of date as it is only periodically refreshed. As such, the data that Kometa applies using `mdb_` operations applies may not be the same as you see if you visit those third-party sources directly.
+
`mdb` | Use MDBList for Content Ratings |
`mdb_commonsense` | Use Common Sense Rating through MDBList for Content Ratings |
@@ -274,7 +278,11 @@ You can create individual blocks of operations by using a list under `operations
**Attribute:** `mass_originally_available_update`
**Accepted Values:** Source or List of sources to use in that order
-
+
+ ???+ tip "Note on `mdb` sources"
+
+ MDBList is not a live reflection of third-party sites such as CommonSense and Trakt. The data on MDBList is often days, weeks and months out of date as it is only periodically refreshed. As such, the data that Kometa applies using `mdb_` operations applies may not be the same as you see if you visit those third-party sources directly.
+
`tmdb` | Use TMDb Release Date |
`tvdb` | Use TVDb Release Date |
@@ -313,7 +321,11 @@ You can create individual blocks of operations by using a list under `operations
**Attribute:** `mass_added_at_update`
**Accepted Values:** Source or List of sources to use in that order
-
+
+ ???+ tip "Note on `mdb` sources"
+
+ MDBList is not a live reflection of third-party sites such as CommonSense and Trakt. The data on MDBList is often days, weeks and months out of date as it is only periodically refreshed. As such, the data that Kometa applies using `mdb_` operations applies may not be the same as you see if you visit those third-party sources directly.
+
`tmdb` | Use TMDb Release Date |
`tvdb` | Use TVDb Release Date |
@@ -363,7 +375,11 @@ You can create individual blocks of operations by using a list under `operations
**Attribute:** `mass_audience_rating_update`/`mass_critic_rating_update`/`mass_user_rating_update`
**Accepted Values:** Source or List of sources to use in that order
-
+
+ ???+ tip "Note on `mdb` sources"
+
+ MDBList is not a live reflection of third-party sites such as CommonSense and Trakt. The data on MDBList is often days, weeks and months out of date as it is only periodically refreshed. As such, the data that Kometa applies using `mdb_` operations applies may not be the same as you see if you visit those third-party sources directly.
+
`tmdb` | Use TMDb Rating |
`imdb` | Use IMDb Rating |
@@ -450,15 +466,10 @@ You can create individual blocks of operations by using a list under `operations
TV Shows:
operations:
mass_episode_audience_rating_update:
- - mdb
- - mdb_average
+ - tmdb
- 2.0
mass_episode_critic_rating_update:
- imdb
- - omdb
- - 2.0
- mass_episode_user_rating_update:
- - trakt_user
- 2.0
```
diff --git a/docs/files/builders/mdblist.md b/docs/files/builders/mdblist.md
index 7ead3475..67576851 100644
--- a/docs/files/builders/mdblist.md
+++ b/docs/files/builders/mdblist.md
@@ -6,6 +6,10 @@ You can find items using the features of [MDBList.com](https://mdblist.com/) (MD
|:--------------------------------|:--------------------------------------------------------------------------|:------------------------------------------:|:------------------------------------------:|:------------------------------------------:|
| [`mdblist_list`](#mdblist-list) | Gets every movie/show in a [MDBList List](https://mdblist.com/toplists/). | :fontawesome-solid-circle-check:{ .green } | :fontawesome-solid-circle-check:{ .green } | :fontawesome-solid-circle-check:{ .green } |
+???+ tip "Note on `mdb` sources"
+
+ MDBList is not a live reflection of third-party sites such as CommonSense and Trakt. The data on MDBList is often days, weeks and months out of date as it is only periodically refreshed. As such, the data that Kometa fetches and applies from MDBList may not be the same as you see if you visit those third-party sources directly.
+
## MDBList List
Finds every item in a [MDBList List](https://mdblist.com/toplists/).
diff --git a/docs/files/overlays.md b/docs/files/overlays.md
index d4957dde..73077de4 100644
--- a/docs/files/overlays.md
+++ b/docs/files/overlays.md
@@ -335,6 +335,7 @@ Each Special Text Variables has multiple modifiers that can be used to format th
| `anidb_score_rating` | AniDB Score Rating | `Movies` or `Shows` |
| `mal_rating` | MyAnimeList Rating | `Movies` or `Shows` |
+
??? tip "Special Rating Text Modifiers"
| Modifier | Description | Example |
@@ -344,6 +345,10 @@ Each Special Text Variables has multiple modifiers that can be used to format th
| `#` | Rating on a 10 point scale removing `.0` as needed | `8.7`, `9` |
| `/` | Rating on a 5 point scale | `8.6` shows as `4.3`, `9.0` shows as `4.5` |
+???+ tip "Note on `mdb` sources"
+
+ MDBList is not a live reflection of third-party sites such as CommonSense and Trakt. The data on MDBList is often days, weeks and months out of date as it is only periodically refreshed. As such, the data that Kometa applies using `mdb_` operations applies may not be the same as you see if you visit those third-party sources directly.
+
##### Special String Text
| Variable | Description | Item Types |
diff --git a/docs/kometa/guides/ratings.md b/docs/kometa/guides/ratings.md
index fb45d8bf..149394fe 100644
--- a/docs/kometa/guides/ratings.md
+++ b/docs/kometa/guides/ratings.md
@@ -229,6 +229,10 @@ Let's change the Trakt rating to that trakt public rating of `85%` instead, whic
* `reapply_overlays: true` should NEVER be used in a live/production environment without a very specific reason, make sure to switch this back to `false` when finished.
+ ???+ tip "Note on `mdb` sources"
+
+ MDBList is not a live reflection of third-party sites such as CommonSense and Trakt. The data on MDBList is often days, weeks and months out of date as it is only periodically refreshed. As such, the data that Kometa applies using `mdb_` operations applies may not be the same as you see if you visit those third-party sources directly.
+
When the above is run you should get:
![](images/ratings-09.png)
@@ -266,6 +270,11 @@ Now, finally, let's make the poster rating images match the numbers we put in th
* `reapply_overlays: true` should NEVER be used in a live/production environment without a very specific reason, make sure to switch this back to `false` when finished.
+ ???+ tip "Note on `mdb` sources"
+
+ MDBList is not a live reflection of third-party sites such as CommonSense and Trakt. The data on MDBList is often days, weeks and months out of date as it is only periodically refreshed. As such, the data that Kometa applies using `mdb_` operations applies may not be the same as you see if you visit those third-party sources directly.
+
+
When the above is run you should get:
![](images/ratings-10.png)