Skip to content

Commit ea02015

Browse files
authored
Update browser compatibility info pages (#10599)
* update browser version page * update browser tech page * adjust intro
1 parent 75721da commit ea02015

File tree

2 files changed

+76
-62
lines changed

2 files changed

+76
-62
lines changed

common-docs/browsers.md

Lines changed: 70 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,38 @@
11
# Supported Browsers
22

3+
You can experience MakeCode on a number of different operating system and browsers. In order to provide the best performance and support for features, the compatibility lists of browsers and operating system support for MakeCode is shown in the following sections.
4+
35
## Windows
46

5-
You need one of these browsers running on Windows 7, Windows 8, Windows 8.1, or
6-
Windows 10:
7+
You need to have one of these **Windows** versions:
8+
9+
* Windows 11
10+
* Windows 10
11+
* Windows 8.1
12+
* Windows 8
13+
* Windows 7
14+
15+
The compatible **Windows** browsers are:
716

817
* Microsoft Edge ([Download](https://www.microsoft.com/en-us/edge))
918
* Google Chrome
1019
* Mozilla Firefox
1120

1221
## Mac
1322

14-
You need one of these browsers running on OS X 10.9 Mavericks, OS X 10.10
15-
Yosemite, OS X 10.11 El Capitan, or macOS 10.12 Sierra:
23+
You need to have one of these **macOS** versions:
24+
25+
* Sequoia 15
26+
* Sonoma 14
27+
* Ventura 13
28+
* Monterey 12
29+
* Big Sur 11
30+
* Catalina 10.15
31+
* Mojave 10.14
32+
* High Sierra 10.13
33+
* Sierra 10.12
34+
35+
The compatible **macOS** browsers are:
1636

1737
* Safari
1838
* Microsoft Edge
@@ -21,95 +41,105 @@ Yosemite, OS X 10.11 El Capitan, or macOS 10.12 Sierra:
2141

2242
## iOS
2343

44+
The compatible **iOS** browsers are:
45+
2446
* Safari
2547
* Microsoft Edge
2648
* Google Chrome
2749

2850
## Android
2951

52+
The compatible **Android** browsers are:
53+
3054
* Google Chrome
3155
* Microsoft Edge
3256

3357
## Linux
3458

35-
If you're using a Raspberry Pi, please see [the documentation
36-
here](/raspberry-pi).
37-
38-
You need to be running a Linux distribution recent enough to run the most recent
59+
You need to have a **Linux** distribution recent enough to run the most recent
3960
version of one of the following:
4061

4162
* Google Chrome or Chromium
4263
* Mozilla Firefox
4364

4465
## Chrome OS
4566

67+
You need to have a **Chrome OS** version of:
68+
4669
* Version 70 or higher
4770

4871
## Internet Explorer
4972

50-
Internet Explorer (IE) is **not** supported. Please upgrade to Microsoft Edge ([Download](https://www.microsoft.com/en-us/edge)) or use one of the other supported browsers. You can check the settings to see if you are running Interent Explorer.
73+
### ~ alert
74+
75+
#### Internet Explorer NOT supported!
76+
77+
Internet Explorer (IE) is **NOT** supported. Check your browser settings to see if you are running Internet Explorer. The version information will look like this:
5178

5279
![Internet Explorer version](/static/configurations/ie-version.png)
5380

81+
Are you using Internet Explorer? Please [upgrade to Microsoft Edge](https://www.microsoft.com/en-us/edge) or use one of the other supported browsers.
82+
83+
### ~
84+
5485
## How to check your OS or browser
5586

87+
If you need to find out which version of operating system (OS) and browser you currently have, see the following instructions to find out which versions they are:
88+
5689
### Windows
5790

58-
* Click on the Start menu
59-
* Type 'System'
60-
* Click on the app called 'System'
61-
* The version of Windows you are using will be displayed:
91+
1. Click on the Start menu
92+
2. Type 'System'
93+
3. Click on the app called 'System'
94+
4. The version of Windows you are using will be displayed:
6295

63-
![](/static/configurations/windows-version.png)
96+
![Windows version dialog](/static/configurations/windows-version.png)
6497

6598
### Mac
6699

67-
* Click on the Apple icon in the top left
68-
* Click on 'About this Mac'
69-
* This window will be displayed:
100+
1. Click on the Apple icon in the top left
101+
2. Click on 'About this Mac'
102+
3. This window will be displayed:
70103

71-
![](/static/configurations/osx-version.png)
104+
![macOS version dialog](/static/configurations/osx-version.png)
72105

73106

74107
### Microsoft Edge
75108

76-
Microsoft Edge automatically updates, so you should always be using the latest version
109+
Microsoft Edge automatically updates, so you should always be using the latest version.
77110

78-
* Click on the menu icon in the top right (three dots)
79-
* Scroll to the bottom
80-
* Information similar to the following will be displayed:
111+
1. Click on the menu icon in the top right (three dots)
112+
2. Scroll to the bottom
113+
3. Information similar to the following will be displayed:
81114

82-
![](/static/configurations/edge-version.png)
115+
![Microsoft Edge version dialog](/static/configurations/edge-version.png)
83116

84117
### Google Chrome
85118

86-
Google Chrome automatically updates, so you should always be using the latest version
119+
Google Chrome automatically updates, so you should always be using the latest version.
87120

88-
* Click on the menu icon in the top right (three dots)
89-
* Click Help, and About Google Chrome
90-
* Information similar to the following will be displayed:
121+
1. Click on the menu icon in the top right (three dots)
122+
2. Click Help, and About Google Chrome
123+
3. Information similar to the following will be displayed:
91124

92-
![](/static/configurations/chrome-version.png)
125+
![Chrome version dialog](/static/configurations/chrome-version.png)
93126

94127
### Firefox
95128

96-
Firefox automatically updates, so you should always be using the latest version
129+
Firefox automatically updates, so you should always be using the latest version.
97130

98-
* Click on the menu icon in the top right (three horizontal lines)
99-
* Click the question mark icon (help button)
100-
* Click 'About Firefox'
131+
1. Click on the menu icon in the top right (three horizontal lines)
132+
2. Click the question mark icon (help button)
133+
3. Click 'About Firefox'
101134

102-
![](/static/configurations/firefox-version.png)
135+
![Firefox version dialog](/static/configurations/firefox-version.png)
103136

104137
### Safari
105138

106139
Safari updates when your operating system updates, so if you are using the
107-
latest version of OS X then you'll be using the latest version of Safari.
108-
109-
* Click on the Safari menu in the top left
110-
* Click 'About Safari'
140+
latest version of macOS then you'll be using the latest version of Safari.
111141

112-
![](/static/configurations/safari-version.png)
142+
1. Click on the Safari menu in the top left
143+
2. Click 'About Safari'
113144

114-
IT administrators should check which browser versions are supported
115-
[here](/browsers/technical).
145+
![Safari version dialog](/static/configurations/safari-version.png)

common-docs/browsers/technical.md

Lines changed: 6 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -6,33 +6,17 @@ This is because the editor uses modern web technologies such as [web
66
workers][] to enable compiling [TypeScript][] in the browser, and includes the
77
same [Monaco][] editor that powers [Visual Studio Code][].
88

9+
Most modern browsers automatically update themselves. In some environments,
10+
such as schools, these automatic updates are disabled for security. **We
11+
strongly recommend that you use the most recent version of any of these
12+
browsers**.
13+
914
[@homeurl@]: @homeurl@
1015
[web workers]: http://www.w3.org/TR/workers/
1116
[typescript]: https://www.typescriptlang.org
1217
[monaco]: https://microsoft.github.io/monaco-editor/
1318
[visual studio code]: https://code.visualstudio.com
14-
15-
Most modern browsers automatically update themselves. In some environments,
16-
such as schools, these automatic updates are disabled for security. **We
17-
strongly recommend that you use the most recent version of any of these
18-
browsers**, but if you can't then you must use at least:
19-
20-
| Browser | Minimum version | Release date | Windows | Mac | Mobile OS |
21-
| ------------------- | --------------- | -------------- | ----------- | ---------- | ---------- |
22-
| Microsoft Edge | 12 | March 2015 | Windows 10+ | N/A | N/A |
23-
| Mozilla Firefox | 60 | May 2018 | Windows 7+ | OS X 10.6+ | N/A |
24-
| Google Chrome | 60 | October 2018 | Windows 7+ | OS X 10.6+ | Android 5+ |
25-
| Safari | 9 | September 2015 | N/A | OS X 10.9+ | N/A |
26-
| Opera | 21 | May 2014 | Windows 7+ | OS X 10.9+ | N/A |
27-
| Mobile Safari | 13 | September 2019 | N/A | N/A | iOS 13+ |
28-
| Chrome for Android | 59 | March 2017 | N/A | N/A | Android 5+ |
29-
| Firefox for Android | 55 | August 2017 | N/A | N/A | Android 5+ |
30-
31-
<br/>
32-
Please see which browsers we recommended for use on [Windows][],
33-
[Mac][], [Linux][], or [Raspberry Pi][].
34-
3519
[Windows]: /browsers/windows
3620
[Mac]: /browsers/mac
3721
[Linux]: /browsers/linux
38-
[Raspberry Pi]: /raspberry-pi
22+
[Raspberry Pi]: /raspberry-pi

0 commit comments

Comments
 (0)