Rewrite install on macOS article

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

@@ -5,8 +5,8 @@ ms.date: 06/21/2023
 ms.topic: include
 ---
 
-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.
+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.
 
-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.
+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.
 
 :::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

@@ -22,19 +22,25 @@ Compare the checksum with the value provided by the download site.
 
 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:
 
-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:
+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:
 
     :::image type="content" source="../media/install-sdk/release-notes-root.png" alt-text="The github release notes version table for .NET":::
 
-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.
+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.
 
 01. In the release page, you can see the .NET Runtime and .NET SDK version, and a link to the checksum file:
 
     :::image type="content" source="../media/install-sdk/release-notes-version.png" alt-text="The download table with checksums for .NET":::
 
-01. Copy the link to the checksum file.
+01. Right-click on the **Checksum** link, and copy the link to your clipboard.
+
+01. Open a terminal.
+
+01. Use `curl -O {link}` to download the checksum file.
 
-01. Use the following script, but replace the link to download the appropriate checksum file:
+    Replace the link in the following command with the link you copied.
 
     ```bash
     curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-sha.txt

docs/core/install/index.yml

@@ -34,9 +34,9 @@ landingContent:
           - text: Install on macOS
             url: macos.md
           - text: Supported macOS releases
-            url: macos.md#supported-releases
+            url: macos.md#supported-versions
           - text: Install alongside Visual Studio Code
-            url: macos.md#install-alongside-visual-studio-code
+            url: macos.md#install-net-for-visual-studio-code
 
   # Card
   - title: Linux

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

@@ -12,7 +12,7 @@ Beginning with macOS Catalina (version 10.15), all software built after June 1,
 
 ## Installing .NET
 
-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).
+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.
 
 ## Native appHost
 

docs/core/install/windows.md

@@ -51,7 +51,7 @@ If you're unsure which method you should choose after reviewing the lists in the
 
 - [Visual Studio Code - C# Dev Kit](#install-with-visual-studio-code)
 
-  Install the **C# Dev Kit** extension for Visual Studio Code to develop .NET apps. This method uses the SDKs you've previously installed.
+  Install the **C# Dev Kit** extension for Visual Studio Code to develop .NET apps. The extension can use an SDK that's already installed or install one for you.
 
 ### Users and Developers
 
@@ -182,17 +182,9 @@ For more information about, see [.NET SDK, MSBuild, and Visual Studio versioning
 
 ## Install with Visual Studio Code
 
-Visual Studio Code uses the versions of .NET already installed on your system. Install .NET using either [.NET Installer](#net-installer) or [Windows Package Manager](#install-with-windows-package-manager-winget). Visual Studio installs its own copy of .NET that can't be used by Visual Studio Code.
+Visual Studio Code is a powerful and lightweight source code editor that runs on your desktop. Visual Studio Code can use the SDK already installed on your system. Additionally, the [C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit) extension will install .NET for you if it's not already installed.
 
-.NET apps are created in Visual Studio Code with the C# Dev Kit extension.
-
-1. First, install the .NET SDK by following the steps in one of the other sections, except for the section on Visual Studio.
-
-   - [.NET Installer](#net-installer)
-   - [Windows Package Manager (WinGet)](#install-with-windows-package-manager-winget)
-
-1. Next, install Visual Studio Code, if you haven't already. For more information, see [Visual Studio Code on Windows](https://code.visualstudio.com/docs/setup/windows).
-1. Lastly, install the C# Dev Kit extension. For more information, see [Getting Started with C# in VS Code](https://code.visualstudio.com/docs/csharp/get-started#_install).
+For instructions on installing .NET through Visual Studio Code, see [Getting Started with C# in VS Code](https://code.visualstudio.com/docs/csharp/get-started).
 
 ## .NET Installer
 

docs/core/runtime-discovery/troubleshoot-app-launch.md

@@ -237,7 +237,7 @@ For example, the error message in the previous section would correspond to:
 ./dotnet-install.sh --architecture x64 --install-dir /usr/local/share/dotnet/ --runtime dotnet --version 5.0.15
 ```
 
-For more information on installation using the script, see [Install with bash automation](../install/macos.md#install-with-bash-automation).
+For more information on installation using the script, see [Install .NET with a script](../install/macos.md#install-net-with-a-script).
 ::: zone-end
 
 ### Download binaries
@@ -253,7 +253,7 @@ For more information about manual installation, see [Install .NET on Linux](../i
 ::: zone-end
 
 ::: zone pivot="os-macos"
-For more information about manual installation, see [Install .NET on macOS](../install/macos.md#manual-install)
+For more information about manual installation, see [Install .NET on macOS](../install/macos.md#install-net-manually)
 ::: zone-end
 
 ### Configure roll-forward behavior

docs/core/tools/dotnet-install-script.md

@@ -46,7 +46,7 @@ The bash script also reads PowerShell switches, so you can use PowerShell switch
 The `dotnet-install` scripts perform a non-admin installation of the .NET SDK, which includes the .NET CLI and the shared runtime. There are two scripts:
 
 * A PowerShell script that works on Windows. For installation instructions, see [Install on Windows](../install/windows.md#install-with-powershell).
-* A bash script that works on Linux/macOS. For installation instructions, see [Install on Linux](../install/linux-scripted-manual.md#scripted-install) and [Install on macOS](../install/macos.md#install-with-bash-automation).
+* A bash script that works on Linux/macOS. For installation instructions, see [Install on Linux](../install/linux-scripted-manual.md#scripted-install) and [Install on macOS](../install/macos.md#install-net-with-a-script).
 
 > [!NOTE]
 > .NET collects telemetry data. To learn more and how to opt out, see [.NET SDK telemetry](telemetry.md).