diff --git a/Compatibility.md b/Compatibility.md
index 9ff8a32..3adc607 100644
--- a/Compatibility.md
+++ b/Compatibility.md
@@ -1,5 +1,20 @@
 
-###  Supported Subsonic API version:
+###  Supported Subsonic API endpoints
+
+This is an (almost) up to date list of all endpoints implemented by GoSonic. As noted in the "Notes" column,
+some of them have some sort of limitation, usually because it is incomplete or because of a functionality 
+not supported by iTunes. Also keep in mind these differences between iTunes+GoSonic and Subsonic:
+
+* iTunes doesn't support rating artists (stars or loved)
+* iTunes is a single user app, so ratings and stars are always the same for all users 
+* Right now, GoSonic only works with a single iTunes library
+* GoSonic tries to mark songs as skipped, if your client properly uses the 
+`submission` param for `scrobble` (DSub does)
+* GoSonic does not mark the song as played by calls to `stream`, only when 
+`scrobble` is called with `submission=true`
+* It can take up to 1 minute for media annotation calls to be reflected 
+in other endpoint calls 
+
 
 | ENDPOINT               | PROGRESS    |  NOTES |
 |------------------------|:-----------:|--------|