GM4 doc update (#1606)

* Been putting this off for a while since the UI has changed a lot but seems to be stabilized.

Auto-merge

Author: Martii

views/includes/documents/Greasemonkey-for-Firefox.md

@@ -9,9 +9,9 @@ To get userscripts going in Greasemonkey, first you have to install it from the
 
 ![Screenshot of Greasemonkey page at addons.mozilla.org][greasemonkeyAMOscreenshot1]
 
-From the Greasemonkey page on AMO, click the green "+ Add to Firefox" button to install the extension. Firefox will show a warning and ask you to confirm the extension. Click "Install".
+From the Greasemonkey page on AMO, click the blue "+ Add to Firefox" button to install the extension. Firefox will show a warning and ask you to confirm adding the extension. Click "Add".
 
-Firefox will prompt you to restart to complete the installation. You can either restart straight away, or finish what you were doing, close all Firefox windows, then start the browser up again. When Firefox restarts, you may see it do a compatibility check on your add-ons. Once it has finished, you should see Greasemonkey's monkey icon at the top of the window, near the search box.
+Once it has finished, you should see Greasemonkey's monkey icon at the top of the window, near the address bar.
 
 ### Installing Userscripts
 
@@ -21,27 +21,29 @@ Once Greasemonkey is installed, installing userscripts from [OpenUserJS.org][ouj
 
 A confirmation dialog box should pop up, showing you details about the script and the websites it can access. Click "Install" if you want to go ahead, and you should get a confirmation that the script has been installed.
 
+If you only see a white boxed window try resizing it with the mouse grippy usually around the window border until the contents are visible as shown below:
+
 ![Screenshot of Greasemonkey script installation warning][greasemonkeyInstallationScreenshot]
 
-Sometimes, Greasemonkey shows you the source code of the userscript, rather than popping up the installation dialog straight away. At the top, there should be a prompt asking you whether to install it. Click "Install script", and you should get the installation dialog as normal.
+Sometimes, you may see just the source code of the userscript, rather than popping up the installation dialog straight away. Usually this means Greasemonkey is disabled. You will need to reenable it from the Greasemonkey monkey icon and reinstall. However if you ticked the "Open in editor after install completes" option the editor will open. You may choose to install a Userscript in a disabled state as well.
 
 Installing userscripts from other sources is a similar process. You just need to find the installation link for the script. This will be a button or link to a file with a name that ends ".user.js"
 
 After installing a userscript, you won't normally notice any further changes until you visit, or refresh, a website that it runs on.
 
 ### Managing Userscripts
 
-If you click the arrow to the right of Greasemonkey's monkey icon, there is an option to "Manage User Scripts..." This will take you to a User Scripts page in Firefox's Add-ons Manager, which you can also find at [about:addons][aboutAddons]. Buttons here let you enable, disable or remove each installed script. Clicking the gear icon above the list will let you check for updates *(by default, Greasemonkey also does weekly automatic checks)*.
+If you click the Greasemonkey's monkey icon, currently there is a list of installed Userscripts. Menu items here let you enable, disable or remove each installed script. Under each script menu entry in a sub-menu is the manual or automatic check for updates.
 
-![Screenshot of Firefox Add-ons Manager User Scripts page][aomUserScriptsScreenshot]
+![Screenshot of Firefox Add-ons Manager with Greasemonkey monkey menu][aomUserScriptsScreenshot]
 
 ### Trouble shooting
 
-If you think a userscript is causing problems, the easiest way to check is to switch off Greasemonkey, reload the web page, and see if the symptoms go away. You can turn it on or off by clicking the monkey icon, which should turn grey when disabled. A common problem is doing this by accident!
+If you think a userscript is causing problems, the easiest way to check is to switch off Greasemonkey, reload the web page, and see if the symptoms go away. You can turn it on or off by clicking the monkey icon and toggling the "Greasemonkey is active" to a disabled state. Remember to refresh any applicable windows and/or tabs.
 
-If it looks like you have a script problem and you have more than one script running on a web page, you can disable all of them in the Add-ons Manager, then re-enable them one by one, until you find the culprit. Remember to reload the web page each time - userscripts normally only run when a web page loads.
+If it looks like you have a script problem and you have more than one script running on a web page, you can disable all of them in the Greasemonkey monkey menu, then re-enable them one by one, until you find the culprit. Remember to reload the web page each time - userscripts normally only run when a web page loads.
 
-Sometimes, when you use more than one userscript on the same web page, they need to run in a particular order. You can also use the Add-ons Manager to achieve this. Click "Execution Order" above the list of scripts to see what order they will run in, then right-click on the individual scripts to make them execute first, last, sooner or later.
+Sometimes, when you use more than one userscript on the same web page, they may need to run in a particular order. The latest release of Greasemonkey does not currently accommodate this natively.
 
 Sometimes, usually on a portable device, it may look like the userscript manager is not working. Try closing all tabs and load them fresh.
 
@@ -55,7 +57,7 @@ Sometimes, usually on a portable device, it may look like the userscript manager
 [oujs]: https://openuserjs.org/
 [amoGreasemonkey]: https://addons.mozilla.org/firefox/addon/greasemonkey/
 [aboutAddons]: about:addons
-[aomUserScriptsScreenshot]: https://raw.githubusercontent.com/wiki/OpenUserJS/OpenUserJS.org/images/greasemonkey5.png "Userscript management in Firefox"
+[aomUserScriptsScreenshot]: https://raw.githubusercontent.com/wiki/OpenUserJS/OpenUserJS.org/images/greasemonkey5.gif "Userscript management in Firefox"
 [greasespot]: https://www.greasespot.net/
 [greasemonkeyIcon]: https://raw.githubusercontent.com/wiki/OpenUserJS/OpenUserJS.org/images/greasemonkey_icon.png "Greasemonkey"
 [greasemonkeyAMOscreenshot1]: https://raw.githubusercontent.com/wiki/OpenUserJS/OpenUserJS.org/images/greasemonkey1.gif "Greasemonkey at Mozilla Add-Ons"