diff --git a/README.rst b/README.rst
index 9b14efe46c1de5fb06b836876e7cf429fcd6e2dc..0b2d915d3a0cddf76f105befb35893eb969f1ddc 100644
--- a/README.rst
+++ b/README.rst
@@ -60,7 +60,7 @@ Release process
 
     # OLMKit CocoaPod release
     # Make sure the version OLMKit.podspec is the same as the git tag
-    # (this should be checked before git tagging)
+    # (this must be checked before git tagging)
     pod spec lint OLMKit.podspec --use-libraries --allow-warnings
     pod trunk push OLMKit.podspec --use-libraries --allow-warnings
     # Check the pod has been successully published with:
diff --git a/xcode/README.rst b/xcode/README.rst
index db78e57bdbe2316f1e5b18d7ce2edad727953f33..d56fa85d39d9d475e85b91a38a748e5d6d9f9fb1 100644
--- a/xcode/README.rst
+++ b/xcode/README.rst
@@ -18,5 +18,9 @@ Run `pod install` and open `OLMKit.xcworkspace`.
 
 The project contains only tests files. The libolm and the Objective-C wrapper source files are loaded via the OLMKit CocoaPods pod.
 
-To add a new source file, add it to the file system and run `pod update` to make CocoaPods insert into OLMKit.xcworkspace. 
+To add a new source file, add it to the file system and run `pod update` to make CocoaPods insert it into OLMKit.xcworkspace. 
+
+Release
+-------
+See ../README.rst for the release of the CocoaPod.