diff --git a/docs/errata/README.md b/docs/errata/README.md index 0aee850..e7a3808 100644 --- a/docs/errata/README.md +++ b/docs/errata/README.md @@ -2,7 +2,7 @@ If you find any mistakes in the seventh edition, *C# 11 and .NET 7 - Modern Cross-Platform Development Fundamentals*, or if you have suggestions for improvements, then please [raise an issue in this repository](https://github.com/markjprice/cs11dotnet7/issues) or email me at markjprice (at) gmail.com. -[**Errata** (44 items)](errata.md): Typos, tool user interface changes, or mistakes in code that would cause a compilation error that prevents a successful build. +[**Errata** (47 items)](errata.md): Typos, tool user interface changes, or mistakes in code that would cause a compilation error that prevents a successful build. [**Improvements** (41 items)](improvements.md): Changes to text or code that would improve the content. These are optional. diff --git a/docs/errata/errata.md b/docs/errata/errata.md index 264357b..658d410 100644 --- a/docs/errata/errata.md +++ b/docs/errata/errata.md @@ -1,11 +1,14 @@ -**Errata** (44 items) +**Errata** (47 items) If you find any mistakes, then please [raise an issue in this repository](https://github.com/markjprice/cs11dotnet7/issues) or email me at markjprice (at) gmail.com. > Microsoft has changed their domain for documentation from `https://docs.microsoft.com` to `https://learn.microsoft.com` with an automatic redirect so all links in my books that use the `docs` domain should still work. - [Page 4, 8 - Pros and cons of the .NET Interactive Notebooks extension, Downloading and installing Visual Studio Code](#page-4-8---pros-and-cons-of-the-net-interactive-notebooks-extension-downloading-and-installing-visual-studio-code) +- [Page 8 - Installing other extensions](#page-8---installing-other-extensions) - [Page 11 - Understanding the journey to one .NET and Understanding .NET support](#page-11---understanding-the-journey-to-one-net-and-understanding-net-support) +- [Page 28 - Writing code using Visual Studio Code](#page-28---writing-code-using-visual-studio-code) +- [Page 31 - Adding a second project using Visual Studio Code](#page-31---adding-a-second-project-using-visual-studio-code) - [Page 36 - Getting help for the dotnet tool](#page-36---getting-help-for-the-dotnet-tool) - [Page 37 - Getting definitions of types and their members](#page-37---getting-definitions-of-types-and-their-members) - [Page 75 - Comparing double and decimal types](#page-75---comparing-double-and-decimal-types) @@ -62,6 +65,12 @@ The **.NET Interactive Notebooks** extension has been renamed to **Polyglot Note I wrote that "They cannot read input from the user, for example, you cannot use ReadLine or ReadKey." Although you cannot use the `Console` class methods, you can use the `Microsoft.DotNet.Interactive.Kernel` class and its `GetInputAsync` method. This uses the Visual Studio Code user interface to prompt the user for input. +# Page 8 - Installing other extensions + +In the table, the C# for Visual Studio Code says it is "powered by OmniSharp". This is true up to the most recent release version `1.25.9`. But if you install the pre-release version `2.0.x` then it does not include OmniSharp any more. + +To follow the instructions in the book, if you have installed the pre-release version `2.0.x` then I recommend that you click the button Switch to Release Version to revert back to the current release version `1.25.9`. + # Page 11 - Understanding the journey to one .NET and Understanding .NET support Even-numbered .NET releases like .NET 6 and .NET 8 have a support level named **Long Term Support (LTS)** with a duration of 3 years. Odd-numbered .NET releases like .NET 5 and .NET 7 had a support level named **Current** with a duration of 18 months. @@ -74,6 +83,20 @@ On October 28, 2022, the .NET team changed the name *again*, to [**Standard Term *Sigh.* Such are the perils of trying to be up-to-date on release day. +# Page 28 - Writing code using Visual Studio Code + +In Step 18, I wrote, "Visual Studio Code may have to download and install C# dependencies like OmniSharp, .NET Core Debugger, and Razor Language Server". This is true up to the most recent release version `1.25.9`. But if you install the pre-release version `2.0.x` then it does not include OmniSharp any more. + +To follow the instructions in the book, if you have installed the pre-release version `2.0.x` then I recommend that you click the button Switch to Release Version to revert back to the current release version `1.25.9`. + +# Page 31 - Adding a second project using Visual Studio Code + +In Step 7, I wrote, "Enter `omni`, and then, in the drop-down list that appears, select **OmniSharp: Select Project**." + +This works if you installed the most recent release version `1.25.9`. But if you installed the pre-release version `2.0.x` then it does not include OmniSharp any more. + +To follow the instructions in the book, if you have installed the pre-release version `2.0.x` then I recommend that you click the button Switch to Release Version to revert back to the current release version `1.25.9`. + # Page 36 - Getting help for the dotnet tool Step 1 is about opening a web browser to show the documentation for a `dotnet` command. It follows this syntax: