diff --git a/docs/browsers.md b/docs/browsers.md index 3aeece82..e3ae501a 100644 --- a/docs/browsers.md +++ b/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). diff --git a/docs/browsers/linux.md b/docs/browsers/linux.md index 4f5d8bd3..87218dda 100644 --- a/docs/browsers/linux.md +++ b/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 -Chrome. +As you are using Linux, it is recommended that you use [Mozilla +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 diff --git a/docs/browsers/mac.md b/docs/browsers/mac.md index 61932f28..c1cb98fc 100644 --- a/docs/browsers/mac.md +++ b/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, -Google Chrome and Mozilla Firefox are also supported. +As you are using a Mac, it is recommended that you use [Safari][]. Alternatively, +[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 diff --git a/docs/browsers/technical.md b/docs/browsers/technical.md new file mode 100644 index 00000000..5dac2f0f --- /dev/null +++ b/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 diff --git a/docs/browsers/windows.md b/docs/browsers/windows.md index 386b65c7..6996a04a 100644 --- a/docs/browsers/windows.md +++ b/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 -are running a version of Windows prior to Windows 10, you can use Internet -Explorer 11. Alternatively, Google Chrome and Mozilla Firefox are also -supported. +We recommend [Microsoft Edge][edge] if you are running Windows 10, but users on +Windows 7 or higher can use [Internet Explorer 11][ie] or recent versions of +[Mozilla Firefox][firefox], [Google Chrome][chrome], or [Opera][opera]. -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