diff --git a/pages/osx/pod.md b/pages/osx/pod.md
index f8bfad2096..c33b03e6a7 100644
--- a/pages/osx/pod.md
+++ b/pages/osx/pod.md
@@ -1,19 +1,31 @@
 # pod
 
-> CocoaPods, the Cocoa library package manager.
+> Dependency manager for Swift and Objective-C Cocoa projects.
 
-- init
+- Create a Podfile for the current project with the default contents:
 
 `pod init`
 
-- install
+- Download all pod defined in Podfile and create an Xcode Pods library project in `./Pods`:
 
 `pod install`
 
-- install --no-repo-update
+- Download a new pod for the current project and add it to the Podfile:
 
-`pod install --no-repo-update`
+`pod install {{pod_name}}`
 
-- update
+- Show the outdated pods in the current `Podfile.lock`:
+
+`pod outdated`
+
+- Update all pods in the current project to their newest version:
 
 `pod update`
+
+- Update a specific pod in the current project to their newest version:
+
+`pod update {{pod_name}}`
+
+- Remove CocoaPods from a Xcode project:
+
+`pod deintegrate {{xcode_project}}`