diff --git a/lib/manager/cocoapods/readme.md b/lib/manager/cocoapods/readme.md
index d57162968f606a90750b6863c17efe5146b9b70c..56f30f94e6e31bb3866a67299da8f98465aea853 100644
--- a/lib/manager/cocoapods/readme.md
+++ b/lib/manager/cocoapods/readme.md
@@ -1,9 +1,3 @@
-The `cocoapods` manager extracts dependencies with`datasource` type `pod`. It is currently in beta so disabled by default. To opt-in to the beta, add the following to your configuration:
+The `cocoapods` manager supports extracting both "pod" type references as well as dependencies on GitHub repositories that use versioned tags.
 
-```json
-{
-  "cocoapods": {
-    "enabled": true
-  }
-}
-```
+Whenever a `Podfile` is updated, Renovate will also update any accompanying `Podfile.lock` file. This is done using the `cocoapods` gem which runs within the Ruby runtime.