Merge remote-tracking branch 'origin/master' into rnmobile/rich_text_…

…sync

# Conflicts:
#	packages/element/src/index.js
#	packages/element/src/platform.js

packages/element/src/index.js

@@ -1,6 +1,6 @@
 export * from './react';
 export * from './react-platform';
 export * from './utils';
-export { default as Platform } from './platform'; 
+export { default as Platform } from './platform';
 export { default as renderToString } from './serialize';
 export { default as RawHTML } from './raw-html';

packages/element/src/platform.js

@@ -1,9 +1,32 @@
+/**
+ * Parts of this source were derived and modified from react-native-web,
+ * released under the MIT license.
+ *
+ * Copyright (c) 2016-present, Nicolas Gallagher.
+ * Copyright (c) 2015-present, Facebook, Inc.
+ *
+ */
 const Platform = {
 	OS: 'web',
-	select: ( obj ) => ( 'web' in obj ? obj.web : obj.default ),
+	select: ( spec ) => ( 'web' in spec ? spec.web : spec.default ),
 };
 /**
- * Component used to detect the current Platform being used. Use Platform.OS === 'web' to detect if running on web enviroment.
- * This is the same concept as the React-Native implementation found here: https://facebook.github.io/react-native/docs/platform-specific-code#platform-module
+ * Component used to detect the current Platform being used.
+ * Use Platform.OS === 'web' to detect if running on web enviroment.
+ *
+ * This is the same concept as the React Native implementation.
+ *
+ * @see https://facebook.github.io/react-native/docs/platform-specific-code#platform-module
+ *
+ * Here is an example of how to use the select method:
+ * @example
+ * ```js
+ * import { Platform } from '@wordpress/element';
+ *
+ * const placeholderLabel = Platform.select( {
+ *   native: __( 'Add media' ),
+ *   web: __( 'Drag images, upload new ones or select files from your library.' ),
+ * } );
+ * ```
  */
 export default Platform;