Merge pull request #255 from Microsoft/browser-versions

More detailed information about which browser versions are supported

docs/browsers.md

@@ -99,3 +99,6 @@ latest version of OS X then you'll be using the latest version of Safari.
 * Click 'About Safari'
 
 ![](/static/configurations/safari-version.png)
+
+IT administrators should check which browser versions are supported
+[here](/browsers/technical).

docs/browsers/linux.md

@@ -1,6 +1,16 @@
-# Unsupported configuration
+# Recommended browser for Linux
 
-As you are using Linux, it is recommended that you use Mozilla Firefox or Google
+As you are using Linux, it is recommended that you use [Mozilla
-Chrome.
+Firefox][firefox] or [Google Chrome][chrome].
 
-Please see [here](/browsers) for more information.
+Please see [here][technical] for technical information on which browsers are
+supported, or [here][versions] to check which version you are using.
+
+[edge]: https://www.microsoft.com/en-us/windows/microsoft-edge
+[ie]: https://www.microsoft.com/en-us/download/internet-explorer.aspx
+[firefox]: https://www.mozilla.org/en-US/firefox/new/
+[chrome]: https://www.google.com/chrome/
+[opera]: https://www.opera.com
+[safari]: http://www.apple.com/safari/
+[technical]: /browsers/technical
+[versions]: /browsers

docs/browsers/mac.md

@@ -1,6 +1,16 @@
-# Unsupported configuration
+# Recommended browser for Mac
 
-As you are using OS X, it is recommended that you use Safari. Alternatively,
+As you are using a Mac, it is recommended that you use [Safari][]. Alternatively,
-Google Chrome and Mozilla Firefox are also supported.
+[Google Chrome][chrome] and [Mozilla Firefox][firefox] are also supported.
 
-Please see [here](/browsers) for more information.
+Please see [here][technical] for technical information on which browsers are
+supported, or [here][versions] to check which version you are using.
+
+[edge]: https://www.microsoft.com/en-us/windows/microsoft-edge
+[ie]: https://www.microsoft.com/en-us/download/internet-explorer.aspx
+[firefox]: https://www.mozilla.org/en-US/firefox/new/
+[chrome]: https://www.google.com/chrome/
+[opera]: https://www.opera.com
+[safari]: http://www.apple.com/safari/
+[technical]: /browsers/technical
+[versions]: /browsers

docs/browsers/technical.md

@@ -0,0 +1,36 @@
+# Technical information about browser support
+
+[codethemicrobit.com][] requires that you use a recent version of a modern
+browser, such as Microsoft Edge, Google Chrome, Mozilla Firefox, Safari, Opera,
+or IE11.  This is because the editor uses modern web technologies such as [web
+workers][] to enable compiling [TypeScript][] in the browser, or the using the
+same [Monaco][] editor that powers [Visual Studio Code][].
+
+[codethemicrobit.com]: https://codethemicrobit.com
+[web workers]: http://www.w3.org/TR/workers/
+[typescript]: http://www.typescriptlang.org
+[monaco]: https://microsoft.github.io/monaco-editor/
+[visual studio code]: http://code.visualstudio.com
+
+Most modern browsers automatically update themselves, but in some environments
+such as schools these automatic updates are disabled for security. **We
+strongly recommend that you use the most recent version of any of these
+browsers**, but if you can't then you must use at least:
+
+| Browser           | Minimum version | Release date   | Windows     | Mac        |
+| ----------------- | --------------- | -------------- | ----------- | ---------- |
+| Edge              | 12              | March 2015     | Windows 10+ | N/A        |
+| Internet Explorer | 11              | October 2013   | Windows 7+  | N/A        |
+| Mozilla Firefox   | 31 ESR          | July 2014      | Windows XP+ | OS X 10.6+ |
+| Google Chrome     | 38              | October 2014   | Windows XP+ | OS X 10.6+ |
+| Safari            | 9               | September 2015 | N/A         | OS X 10.9+ |
+| Opera             | 21              | May 2014       | Windows 7+  | OS X 10.9+ |
+
+
+Please see our information for which browsers are recommended for [Windows][],
+[Mac][], [Linux][], or [Raspberry Pi][].
+
+[Windows]: /browsers/windows
+[Mac]: /browsers/mac
+[Linux]: /browsers/linux
+[Raspberry Pi]: /raspberry-pi

docs/browsers/windows.md

@@ -1,8 +1,18 @@
-# Unsupported configuration
+# Recommended browser for Windows
 
-As you are using Windows, it is recommended that you use Microsoft Edge. If you
+We recommend [Microsoft Edge][edge] if you are running Windows 10, but users on
-are running a version of Windows prior to Windows 10, you can use Internet
+Windows 7 or higher can use [Internet Explorer 11][ie] or recent versions of
-Explorer 11. Alternatively, Google Chrome and Mozilla Firefox are also
+[Mozilla Firefox][firefox], [Google Chrome][chrome], or [Opera][opera].
-supported.
 
-Please see [here](/browsers) for more information.
+
+Please see [here][technical] for technical information on which browsers are
+supported, or [here][versions] to check which version you are using.
+
+[edge]: https://www.microsoft.com/en-us/windows/microsoft-edge
+[ie]: https://www.microsoft.com/en-us/download/internet-explorer.aspx
+[firefox]: https://www.mozilla.org/en-US/firefox/new/
+[chrome]: https://www.google.com/chrome/
+[opera]: https://www.opera.com
+[safari]: http://www.apple.com/safari/
+[technical]: /browsers/technical
+[versions]: /browsers