From 3686facdda377516ad28bc97284ed920556ce42e Mon Sep 17 00:00:00 2001
From: Emilio Rodriguez <emiliorodriguez@gmail.com>
Date: Wed, 18 Nov 2015 12:04:19 +0100
Subject: [PATCH 1/2] [Docs] Document Platform in the modules section of the
 docs #3701

---
 docs/PlatformSpecificInformation.md | 67 +++++++++++++++++++++++++++++
 docs/Upgrading.md                   |  2 +-
 2 files changed, 68 insertions(+), 1 deletion(-)
 create mode 100644 docs/PlatformSpecificInformation.md

diff --git a/docs/PlatformSpecificInformation.md b/docs/PlatformSpecificInformation.md
new file mode 100644
index 000000000..7e2c5d583
--- /dev/null
+++ b/docs/PlatformSpecificInformation.md
@@ -0,0 +1,67 @@
+---
+id: platform-specific-code
+title: Platform Specific Code
+layout: docs
+category: Guides
+permalink: docs/platform-specific-code.html
+next: native-modules-ios
+---
+
+When building a cross platform app, the need to write different code for different platforms may arise. This can always be achieved by organizing the various components in different folders: 
+
+```sh
+/common/components/   
+/android/components/   
+/ios/components/
+```
+
+Another option may be naming the components differently depending on the platform they are going to be used in:
+
+```sh
+BigButtonIOS.js
+BigButtonAndroid.js
+```
+
+But React Native provides two alternatives to easily organize your code separating it by platform:
+
+## Platform specific extensions
+React Native will detect when a file has a `.ios.` or `.android.` extension and load the right file for each platform when requiring them from other components. 
+
+For example, you can have these files in your project:
+
+```sh
+BigButton.ios.js
+BigButton.android.js
+```
+
+With this setup, you can just require the files from a different component without paying attention to the platform in which the app will run.
+
+```javascript
+var BigButton = require('./components/BigButton');
+```
+
+React Native will import the correct component for the running platform.
+
+## Platform module
+A module is provided by React Native to detect what is the platform in which the app is running. This piece of functionality can be useful when only small parts of a component are platform specific.
+
+```javascript
+var {Platform} = React;
+
+var styles = StyleSheet.create({
+    height: (Platform.OS === 'ios') ? 200 : 100
+});
+```
+
+`Platform.OS` will be `ios` when running in iOS and `android` when running in an Android device or simulator.
+
+###Detecting android version
+On Android, the Platform module can be also used to detect which is the version of the Android Platform in which the app is running
+
+```javascript
+var {Platform} = React;
+
+if(Platform.Version === '5.0'){
+   console.log('Running on Lollipop!');
+}
+```
\ No newline at end of file
diff --git a/docs/Upgrading.md b/docs/Upgrading.md
index e427796f6..aca07b075 100644
--- a/docs/Upgrading.md
+++ b/docs/Upgrading.md
@@ -4,7 +4,7 @@ title: Upgrading
 layout: docs
 category: Guides
 permalink: docs/upgrading.html
-next: native-modules-ios
+next: platform-specific-code
 ---
 
 Upgrading to new versions of React Native will give you access to more APIs, views, developer tools

From 87302ac74b710fb39de216f6769b4c2adb8541e9 Mon Sep 17 00:00:00 2001
From: Emilio Rodriguez <emiliorodriguez@gmail.com>
Date: Tue, 24 Nov 2015 08:44:34 +0100
Subject: [PATCH 2/2] style and typos

---
 docs/PlatformSpecificInformation.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/PlatformSpecificInformation.md b/docs/PlatformSpecificInformation.md
index 7e2c5d583..38345e541 100644
--- a/docs/PlatformSpecificInformation.md
+++ b/docs/PlatformSpecificInformation.md
@@ -7,7 +7,7 @@ permalink: docs/platform-specific-code.html
 next: native-modules-ios
 ---
 
-When building a cross platform app, the need to write different code for different platforms may arise. This can always be achieved by organizing the various components in different folders: 
+When building a cross-platform app, the need to write different code for different platforms may arise. This can always be achieved by organizing the various components in different folders: 
 
 ```sh
 /common/components/   
@@ -49,19 +49,19 @@ A module is provided by React Native to detect what is the platform in which the
 var {Platform} = React;
 
 var styles = StyleSheet.create({
-    height: (Platform.OS === 'ios') ? 200 : 100
+  height: (Platform.OS === 'ios') ? 200 : 100,
 });
 ```
 
 `Platform.OS` will be `ios` when running in iOS and `android` when running in an Android device or simulator.
 
-###Detecting android version
+###Detecting Android version
 On Android, the Platform module can be also used to detect which is the version of the Android Platform in which the app is running
 
 ```javascript
 var {Platform} = React;
 
 if(Platform.Version === '5.0'){
-   console.log('Running on Lollipop!');
+  console.log('Running on Lollipop!');
 }
 ```
\ No newline at end of file