Add migration to WebAssembly information to PNaCl / NaCl docs.

native_client_sdk/src/doc/migration/index.rst

Index: native_client_sdk/src/doc/migration/index.rst
diff --git a/native_client_sdk/src/doc/migration/index.rst b/native_client_sdk/src/doc/migration/index.rst
new file mode 100644
index 0000000000000000000000000000000000000000..1f0c8462d2b25405c612ddcf9b767dcd361fe1fe
--- /dev/null
+++ b/native_client_sdk/src/doc/migration/index.rst
@@ -0,0 +1,77 @@
+.. _migration:
+
+(P)NaCl Migration Guide
+=======================
+
+Deprecation Announcements
+-------------------------
+
+We recently announced the deprecation of Portable NativeClient
+as well as the deprecation of
+`Chrome Apps
+<https://blog.chromium.org/2016/08/from-chrome-apps-to-web.html>`_
+outside of ChromeOS.
+As a result, in the near future, PNaCl will no longer be supported in Chrome.
+And NaCl will be supported only in the context of ChromeOS and Extensions.
+
+We appreciate the investment you've made bringing native code to the Web
+with these pioneering solutions, but have now refocused our efforts
+on the cross browser `WebAssembly <http://webassembly.org>`_ standard
+in order to bring similar functionality to the Web in general.
+While WebAssembly currently cannot match all of (P)NaCl's capabilities,
+we are working to expand its capabilities in tandem with other
+browsers, and believe most use cases will soon be covered.
+
+
+Toolchain Migration
+-------------------
+
+For the majority of (P)NaCl uses cases we recommend transitioning
+from the NaCl SDK to `Emscripten
+<http://webassembly.org/getting-started/developers-guide/>`_.
+While direct support for NaCl / Pepper APIs in not available,
+we've attempted to list equivalents.
+Migration is likely to be reasonably straightforward
+if your application is portable to Linux, uses SDL, or POSIX APIs.
+For more challenging porting cases, please reach out on
+native-client-discuss@googlegroups.com
+
+
+API Migration
+-------------
+
+We've outlined here the status of Web Platform substitutes for each
+of the APIs exposed to (P)NaCl.
+Additionally, the table lists the library or option in Emscripten
+that offers the closest substitute.
+
+We expect to add shared memory threads support to WebAssembly in 2017,
+as threads are crucial to matching (P)NaCl's most interesting use
+cases. Migration items which assume forthcoming threads support
+are marked below. If your application's flow control relies heavily on blocking
+APIs, you may also find threads support is required for convenient porting.
+
+While we've tried to be accurate in this table,
+there are no doubt errors or omissions.
+If you encounter one, please reach out to us on
+native-client-discuss@googlegroups.com
+
+.. contents::
+  :local:
+  :backlinks: none
+  :depth: 2
+
+PPAPI
+-----
+.. raw:: html
+  :file: public.html
+
+IRT
+---
+.. raw:: html
+  :file: public.html
+
+PPAPI (Apps)
+------------
+.. raw:: html
+  :file: apps.html