Skip to content

Commit 1fe88a2

Browse files
committed
Update additional note style in Windows guide
1 parent d42945f commit 1fe88a2

File tree

2 files changed

+22
-8
lines changed

2 files changed

+22
-8
lines changed

install/windows/_scoop.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,9 @@ Invoke-RestMethod get.scoop.sh | Invoke-Expression
2626

2727
The platform dependencies cannot be installed through Scoop as the install rules cannot install all required components. They will be installed through the Visual Studio installer.
2828

29-
> **NOTE:** This code snippet MUST be run in a traditional Command Prompt (`cmd.exe`).
29+
<div class="warning" markdown="1">
30+
This code snippet must be run in a traditional Command Prompt (`cmd.exe`).
31+
</div>
3032

3133
~~~ batch
3234
curl -sOL https://aka.ms/vs/16/release/vs_community.exe

install/windows/_traditional.md

Lines changed: 19 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
## Traditional Installation
22

3-
> **NOTE:** The traditional installation process is required for Swift older than 5.4.2.
3+
<div class="warning" markdown="1">
4+
The traditional installation process is required for Swift older than 5.4.2.
5+
</div>
46

57
Swift has been tested with [Visual Studio](https://visualstudio.microsoft.com) 2019. You will need to install Visual Studio with the following components. The installer for Swift is available in the [Download](/download) section. The toolchain on Windows is typically installed to `%SystemDrive%\Library\Developer\Toolchains`.
68

@@ -34,11 +36,17 @@ After Visual Studio and the required components are installed:
3436

3537
### Support Files
3638

37-
> **NOTE:** This is only required for versions older than 5.4.2.
39+
<div class="info" markdown="1">
40+
This is only required for versions older than 5.4.2.
41+
</div>
3842

39-
You must use the `x64 Native Tools for VS2019 Command Prompt` to run the following steps. The `x64 Native Tools for VS2019 Command Prompt` runs the `DevEnv` script from Visual Studio that sets up the necessary environment variables to find the system headers.
43+
<div class="warning" markdown="1">
44+
You must run the following commands using `x64 Native Tools for VS2019 Command Prompt` as administrator.
45+
The `x64 Native Tools for VS2019 Command Prompt` sets up the necessary environment variables to find the system headers.
46+
Administrator permission is required to modify the Visual Studio Installation.
47+
</div>
4048

41-
In order to make the Windows SDK accessible to Swift, it is necessary to deploy a few files into the Windows SDK. The following will modify your Visual Studio Installation, and as such will require to be run from an (elevated) “Administrator” `x86 Native Tools for VS2019 Command Prompt`.
49+
In order to make the Windows SDK accessible to Swift, it is necessary to deploy a few files into the Windows SDK.
4250

4351
~~~ batch
4452
copy /Y %SDKROOT%\usr\share\ucrt.modulemap "%UniversalCRTSdkDir%\Include\%UCRTVersion%\ucrt\module.modulemap"
@@ -51,13 +59,17 @@ Because it is installing the files into the Visual Studio image, the files will
5159

5260
### Repairing after Visual Studio Updates
5361

54-
> **NOTE:** This is only required for versions older than 5.9.0.
62+
<div class="info" markdown="1">
63+
This is only required for versions older than 5.9.0.
64+
</div>
5565

56-
If Visual Studio is updated, you may have to repair the installation. See Microsoft’s [instructions](https://support.microsoft.com/windows/repair-apps-and-programs-in-windows-10-e90eefe4-d0a2-7c1b-dd59-949a9030f317) for repairing installed programs.
66+
If Visual Studio is updated, you may have to repair the installation. For versions older than 5.4.2, reinstall support files [as mentioned above](#support-files). For newer versions, see Microsoft’s [instructions](https://support.microsoft.com/windows/repair-apps-and-programs-in-windows-10-e90eefe4-d0a2-7c1b-dd59-949a9030f317) for repairing installed programs.
5767

5868
### Code Signing on Windows
5969

60-
> **NOTE:** The following commands MUST be run in PowerShell.
70+
<div class="warning" markdown="1">
71+
The following commands must be run in PowerShell.
72+
</div>
6173

6274
0. Install GPG from [GnuPG.org](https://gnupg.org/download/index.html)
6375

0 commit comments

Comments
 (0)