diff --git a/TODO.md b/TODO.md
index 6bffeab391..120f4ee003 100644
--- a/TODO.md
+++ b/TODO.md
@@ -5,9 +5,7 @@ gstreamer.com content to hotdoc
 
 Pages to review:
  - [installing]
-   - sdk-installing-for-ios-development.md
    - sdk-installing-on-linux.md
-   - sdk-installing-on-mac-osx.md
    - sdk-installing-on-windows.md
    - sdk-installing-for-android-development.md
      - Need to update/review the plugins list
diff --git a/sdk-installing-for-ios-development.md b/sdk-installing-for-ios-development.md
index 67b628cfd0..65a1c70eb4 100644
--- a/sdk-installing-for-ios-development.md
+++ b/sdk-installing-for-ios-development.md
@@ -10,7 +10,7 @@ can be found at the App Store or
 and the iOS SDK, if it is not already included in your version of Xcode,
 can be downloaded from Xcode's preferences menu under the downloads tab.
 The minimum required iOS version is 6.0. The minimum required version of
-Xcode is 4, but 4.5 is recommended.
+Xcode is 4, but 7.3 is recommended.
 
 In case you are not familiar with iOS, Objective-C or Xcode, we
 recommend taking a look at the available documentation at Apple's
@@ -49,7 +49,7 @@ example.
 
 #### Building the tutorials
 
-The GStreamer SDK ships a few tutorials in the `xcode iOS` folder inside
+GStreamer provides a few tutorials in the `xcode iOS` folder inside
 the `.dmg` file. Copy them out of the package and into a more suitable
 place. We recommend that you open the project in Xcode, take a look
 at the sources and build them. This should confirm that the installation
diff --git a/sdk-installing-on-mac-osx.md b/sdk-installing-on-mac-osx.md
index 41bd321af0..abbe08a99e 100644
--- a/sdk-installing-on-mac-osx.md
+++ b/sdk-installing-on-mac-osx.md
@@ -5,6 +5,9 @@
  *  10.6 (Snow Leopard)
  *  10.7 (Lion)
  *  10.8 (Mountain Lion)
+ *  10.9 (Mavericks)
+ *  10.10 (Yosemite)
+ *  10.11 (El Capitan)
 
 ## Prerequisites
 
@@ -16,15 +19,9 @@ OS X Snow Leopard (10.6) or later and
 later.
 
 The recommended system is [Mac OS X
-Lion](http://www.apple.com/macosx/) with
+El Capitan](http://www.apple.com/macosx/) with
 [XCode 4](https://developer.apple.com/xcode/)
 
-Installing the SDK for 32-bits platforms requires approximately 145MB of
-free disk space for the runtime and 193MB for the development files.
-
-Installing the SDK for 64-bits platforms requires approximately 152MB of
-free disk space for the runtime and 223MB for the development files.
-
 ## Download and install the SDK
 
 There are 3 sets of files in the SDK:
@@ -38,18 +35,24 @@ There are 3 sets of files in the SDK:
     with [PackageMaker](https://developer.apple.com/library/mac/#documentation/DeveloperTools/Conceptual/PackageMakerUserGuide/Introduction/Introduction.html)
     to deploy GStreamer with your application
 
-Get **both the runtime and the development installers** from here:
+Get **both the runtime and the development installers** from [here](https://gstreamer.freedesktop.org/data/pkg/osx/).
 
-** FIXME: Update links **
 
 > ![Warning](images/icons/emoticons/warning.png)
 > On Mac OS X 10.6 (Snow Leopard) you have to install Python 2.7 manually. It is included in later versions of OS X already. You can get it from [here](http://www.python.org/getit).
 
-The downloads are [Apple Disk Images
-(.dmg)](http://en.wikipedia.org/wiki/Apple_Disk_Image) containing an
-[Installer Package
-(.pkg)](http://en.wikipedia.org/wiki/Installer_%28Mac_OS_X%29). Double
-click in the installer to start the installation process.
+The downloads are 
+[Installer Packages
+(.pkg)](http://en.wikipedia.org/wiki/Installer_%28Mac_OS_X%29). 
+
+Double click the package file and follow the instructions presented by
+the install wizard. In case the system complains about the package not
+being signed, you can control-click it and open to start the
+installation. When you do this, it will warn you, but there is an option
+to install anyway. Otherwise you can go to System Preferences → Security
+and Privacy → General and select the option to allow installation of
+packages from "anywhere".
+
 
 These are some paths of the GStreamer framework that you might find
 useful:
@@ -83,7 +86,7 @@ folder `/Library/Frameworks/GStreamer.framework/Current/share/gst-sdk/tutorials`
 
 You can fire up XCode and load the project file.
 
-Press the **Run **button to build and run the first tutorial. You can
+Press the **Run** button to build and run the first tutorial. You can
 switch the tutorial to build selecting one of the available schemes.
 
 ### Creating new projects
@@ -97,7 +100,7 @@ There is a small exception to the regular use of frameworks, and you
 will need to manually include the headers search
 path  `/Library/Frameworks/GStreamer.framework/Headers`
 
-  - XCode: Add the headers path to **Search Paths-\> Header Search
+  - XCode: Add the headers path to **Search Paths → Header Search
     Paths**
   - GCC: Using the compiler
-    option** -I/Library/Frameworks/GStreamer.framework/Headers**
+    option **-I/Library/Frameworks/GStreamer.framework/Headers**