diff --git a/docs/tutorial/using-pepper-flash-plugin.md b/docs/tutorial/using-pepper-flash-plugin.md
index cdb4d04ad08..de7c7001cf3 100644
--- a/docs/tutorial/using-pepper-flash-plugin.md
+++ b/docs/tutorial/using-pepper-flash-plugin.md
@@ -1,6 +1,6 @@
 # Using Pepper Flash Plugin
 
-Electron now supports the Pepper Flash plugin. To use the Pepper Flash plugin in
+Electron supports the Pepper Flash plugin. To use the Pepper Flash plugin in
 Electron, you should manually specify the location of the Pepper Flash plugin
 and then enable it in your application.
 
@@ -11,14 +11,11 @@ navigating to `chrome://plugins` in the Chrome browser. Its location and version
 are useful for Electron's Pepper Flash support. You can also copy it to another
 location.
 
-_**Attention:** On windows, Pepper Flash plugin is win32 and it won't work with Electron x64 version. 
-<br>Get win32 version from [Electron Releases](https://github.com/electron/electron/releases)_
-
 ## Add Electron Switch
 
 You can directly add `--ppapi-flash-path` and `ppapi-flash-version` to the
 Electron command line or by using the `app.commandLine.appendSwitch` method
-before the app ready event. Also, add the `plugins` switch of `browser-window`.
+before the app ready event. Also, turn on `plugins` option of `BrowserWindow`.
 For example:
 
 ```javascript
@@ -33,11 +30,10 @@ app.commandLine.appendSwitch('ppapi-flash-version', '17.0.0.169');
 
 app.on('ready', function() {
   mainWindow = new BrowserWindow({
-    'width': 800,
-    'height': 600,
-    // web-preferences is deprecated. Use webPreferences instead.
-    'webPreferences': {
-      'plugins': true
+    width: 800,
+    height: 600,
+    webPreferences: {
+      plugins: true
     }
   });
   mainWindow.loadURL('file://' + __dirname + '/index.html');
@@ -45,8 +41,6 @@ app.on('ready', function() {
 });
 ```
 
-_**Attention:** You can check if Flash dll was loaded by running `navigator.plugins` on the Console (although you can't know if the plugin's path is correct)_
-
 ## Enable Flash Plugin in a `<webview>` Tag
 
 Add `plugins` attribute to `<webview>` tag.
@@ -54,3 +48,13 @@ Add `plugins` attribute to `<webview>` tag.
 ```html
 <webview src="http://www.adobe.com/software/flash/about/" plugins></webview>
 ```
+
+## Troubleshooting
+
+You can check if Pepper Flash plugin was loaded by inspecting
+`navigator.plugins` in the console of devtools (although you can't know if the
+plugin's path is correct).
+
+The architecture of Pepper Flash plugin has to match Electron's one. On Windows,
+a common error is to use 32bit version of Flash plugin against 64bit version of
+Electron.