Skip to content

Commit 107d4fe

Browse files
authored
Rewrite install on macOS article (#43045)
* Screenshots * Complete rewrite using install-set-up-deploy * Fix screenshot reference * Fix cross links * Various fixes * Fix bookmarks * Update docs/core/install/macos.md
1 parent 2ff9b7c commit 107d4fe

14 files changed

+224
-128
lines changed

docs/core/install/includes/verify-download-intro.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ ms.date: 06/21/2023
55
ms.topic: include
66
---
77

8-
After downloading an installer, verify it to make sure that the file hasn't been changed or corrupted. You can verify the checksum on your computer and then compare it to what was reported on the download website.
8+
After downloading an installer or binary release, verify it to make sure that the file hasn't been changed or corrupted. You can verify the checksum on your computer and then compare it to what was reported on the download website.
99

10-
When you download an installer or binary from an official download page, the checksum for the file is displayed. Select the **Copy** button to copy the checksum value to your clipboard.
10+
When you download the file from an official download page, the checksum for the file is displayed in a text box. Select the **Copy** button to copy the checksum value to your clipboard.
1111

1212
:::image type="content" source="../media/install-sdk/checksum.png" alt-text="The .NET download page with checksum":::

docs/core/install/includes/verify-download-macos-linux.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -22,19 +22,25 @@ Compare the checksum with the value provided by the download site.
2222

2323
The .NET release notes contain a link to a checksum file you can use to validate your downloaded file. The following steps describe how to download the checksum file and validate a .NET install binary:
2424

25-
01. The release notes page for .NET 8 on GitHub at <https://github.com/dotnet/core/tree/main/release-notes/8.0> contains a section named **Releases**. The table in that section links to the downloads and checksum files for each .NET 8 release:
25+
01. The release notes page for .NET 8 on GitHub at <https://github.com/dotnet/core/tree/main/release-notes/8.0#releases> contains a section named **Releases**. The table in that section links to the downloads and checksum files for each .NET 8 release:
2626

2727
:::image type="content" source="../media/install-sdk/release-notes-root.png" alt-text="The github release notes version table for .NET":::
2828

29-
01. Select the link for the version of .NET that you downloaded. The previous section used .NET SDK 8.0.100, which is in the .NET 8.0.0 release.
29+
01. Select the link for the version of .NET that you downloaded.
30+
31+
The previous section used .NET SDK 8.0.100, which is in the .NET 8.0.0 release.
3032

3133
01. In the release page, you can see the .NET Runtime and .NET SDK version, and a link to the checksum file:
3234

3335
:::image type="content" source="../media/install-sdk/release-notes-version.png" alt-text="The download table with checksums for .NET":::
3436

35-
01. Copy the link to the checksum file.
37+
01. Right-click on the **Checksum** link, and copy the link to your clipboard.
38+
39+
01. Open a terminal.
40+
41+
01. Use `curl -O {link}` to download the checksum file.
3642

37-
01. Use the following script, but replace the link to download the appropriate checksum file:
43+
Replace the link in the following command with the link you copied.
3844

3945
```bash
4046
curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt

docs/core/install/index.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,9 +34,9 @@ landingContent:
3434
- text: Install on macOS
3535
url: macos.md
3636
- text: Supported macOS releases
37-
url: macos.md#supported-releases
37+
url: macos.md#supported-versions
3838
- text: Install alongside Visual Studio Code
39-
url: macos.md#install-alongside-visual-studio-code
39+
url: macos.md#install-net-for-visual-studio-code
4040

4141
# Card
4242
- title: Linux

docs/core/install/macos-notarization-issues.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Beginning with macOS Catalina (version 10.15), all software built after June 1,
1212

1313
## Installing .NET
1414

15-
The installers for .NET (both runtime and SDK) have been notarized since February 18, 2020. Prior released versions aren't notarized. You can manually install a non-notarized version of .NET by first downloading the installer, and then using the `sudo installer` command. For more information, see [Download and manually install for macOS](./macos.md#manual-install).
15+
The installers for .NET (both runtime and SDK) have been notarized since February 18, 2020. Prior released versions aren't notarized. You can manually install a non-notarized version of .NET by first downloading the installer, and then using the `sudo installer` command with the downloaded installer.
1616

1717
## Native appHost
1818

docs/core/install/macos.md

Lines changed: 203 additions & 105 deletions
Large diffs are not rendered by default.
140 KB
Loading
64.9 KB
Loading
133 KB
Loading
46.4 KB
Loading
238 KB
Binary file not shown.

0 commit comments

Comments
 (0)