diff --git a/API_COMPATIBILITY.md b/API_COMPATIBILITY.md
index d76079941..d8d4ecd0d 100644
--- a/API_COMPATIBILITY.md
+++ b/API_COMPATIBILITY.md
@@ -54,7 +54,7 @@ Navidrome is actively being tested with:
 | `deletePlaylist`       | |
 | ||
 | _MEDIA RETRIEVAL_      ||
-| `stream`               | Experimental Transcoding/Downsampling support available |
+| `stream`               | |
 | `download`             | |
 | `getCoverArt`          | Only gets embedded artwork |
 | `getAvatar`            | Always returns the same image |
diff --git a/README.md b/README.md
index efea6f3bd..b724914fe 100644
--- a/README.md
+++ b/README.md
@@ -25,11 +25,10 @@ our [Discord server](https://discord.gg/xh7j7yF)
 - Automatically monitors your library for changes, importing new files and reloading new metadata 
 - Modern and responsive Web interface based on Material UI, to manage users and browse your library
 - Compatible with all Subsonic/Madsonic/Airsonic clients. See bellow for a list of tested clients
-- Transcoding/Downsampling on-the-fly 
-    (WIP. [Experimental support is available](https://github.com/deluan/navidrome/issues/11#issuecomment-598753796))
+- Transcoding/Downsampling on-the-fly. Can be set per user/player
 - Integrated music player (WIP)
 
-Navidrome is compatible with all Subsonic clients. The following clients are tested and confirmed to work properly:
+Navidrome should be compatible with all Subsonic clients. The following clients are tested and confirmed to work properly:
 - Android:
     - [DSub](https://play.google.com/store/apps/details?id=github.daneren2005.dsub)
     - [Ultrasonic](https://play.google.com/store/apps/details?id=org.moire.ultrasonic)
@@ -43,7 +42,8 @@ Navidrome is compatible with all Subsonic clients. The following clients are tes
     - [Subplayer](https://github.com/peguerosdc/subplayer)
     
 For more options, look at the [list of clients](https://airsonic.github.io/docs/apps/) maintained by 
-the Airsonic project
+the Airsonic project. Please open an [issue](https://github.com/deluan/navidrome/issues) if you have any 
+issues with the client of your choice.
     
 ## Road map
 
@@ -95,9 +95,10 @@ services:
       ND_SCANINTERVAL: 1m
       ND_LOGLEVEL: info  
       ND_PORT: 4533
+      ND_TRANSCODINGCACHESIZE: 100 # MB
     volumes:
       - "./data:/data"
-      - "/path/to/your/music/folder:/music"
+      - "/path/to/your/music/folder:/music:ro"
 ```
 
 To get the cutting-edge, latest version from master, use the image `deluan/navidrome:develop`