From d106fc899c9c99454ef9bc86b269da0d4a506dc5 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Mon, 17 Aug 2020 13:05:01 -0700 Subject: [PATCH 1/3] clean up redirected links --- docs/core/get-started.md | 4 ++-- .../core/install/macos-notarization-issues.md | 2 +- docs/core/tutorials/index.md | 2 +- docs/csharp/tour-of-csharp/index.md | 6 ++--- .../version-update-considerations.md | 2 +- .../security-considerations-for-data.md | 2 +- .../serialization-and-deserialization.md | 2 +- docs/samples-and-tutorials/index.md | 2 +- docs/welcome.md | 2 +- docs/whats-new/2020-07.md | 22 +++++++++---------- docs/whats-new/dotnet-2020-05.md | 2 +- 11 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/core/get-started.md b/docs/core/get-started.md index 0488fe053cd14..926ef5fe524a9 100644 --- a/docs/core/get-started.md +++ b/docs/core/get-started.md @@ -29,7 +29,7 @@ You should see the following output: Hello World! ``` -Congratulations! You've created a simple .NET Core application. You can also use [Visual Studio Code](./tutorials/with-visual-studio-code.md), [Visual Studio](./tutorials/with-visual-studio.md) (Windows only), or [Visual Studio for Mac](./tutorials/using-on-mac-vs.md) (macOS only), to create a .NET Core application. +Congratulations! You've created a simple .NET Core application. You can also use [Visual Studio Code](./tutorials/with-visual-studio-code.md), [Visual Studio](./tutorials/with-visual-studio.md) (Windows only), or [Visual Studio for Mac](tutorials/with-visual-studio-mac.md) (macOS only), to create a .NET Core application. ## Tutorials @@ -68,7 +68,7 @@ Get started developing .NET Core applications by following these step-by-step tu - [Get started with .NET Core on macOS using Visual Studio Code](./tutorials/using-on-macos.md) - [Get started with .NET Core using the command-line](./tutorials/cli-create-console-app.md) -- [Get started with .NET Core on macOS using Visual Studio for Mac](./tutorials/using-on-mac-vs.md) +- [Get started with .NET Core on macOS using Visual Studio for Mac](tutorials/with-visual-studio-mac.md) - [Build a .NET Standard library on macOS using Visual Studio for Mac](tutorials/library-with-visual-studio-mac.md) | | | diff --git a/docs/core/install/macos-notarization-issues.md b/docs/core/install/macos-notarization-issues.md index 20eea1b89b457..92e1ff64a49bc 100644 --- a/docs/core/install/macos-notarization-issues.md +++ b/docs/core/install/macos-notarization-issues.md @@ -87,5 +87,5 @@ If you want your application to run on macOS Catalina (version 10.15) or higher, ## Next steps -- [.NET Core dependencies and requirements](dependencies.md). +- [.NET Core dependencies and requirements](windows.md). - [Install the .NET Core Runtime and SDK](macos.md). diff --git a/docs/core/tutorials/index.md b/docs/core/tutorials/index.md index 4692f058613ad..14c29ebab322a 100644 --- a/docs/core/tutorials/index.md +++ b/docs/core/tutorials/index.md @@ -35,7 +35,7 @@ Choose these tutorials if you want to use Visual Studio Code or some other code ## Use Visual Studio for Mac -- [Create a console app](using-on-mac-vs.md) +- [Create a console app](with-visual-studio-mac.md) - [Create a library and unit test it](library-with-visual-studio-mac.md) - [Install and use a package](/nuget/quickstart/install-and-use-a-package-in-visual-studio-mac) diff --git a/docs/csharp/tour-of-csharp/index.md b/docs/csharp/tour-of-csharp/index.md index a99316eb5dff2..9eefdd795e293 100644 --- a/docs/csharp/tour-of-csharp/index.md +++ b/docs/csharp/tour-of-csharp/index.md @@ -40,7 +40,7 @@ The following outline provides an overview of C#'s type system. - [Simple types](../language-reference/builtin-types/value-types.md#built-in-value-types) - [Signed integral](../language-reference/builtin-types/integral-numeric-types.md): `sbyte`, `short`, `int`, `long` - [Unsigned integral](../language-reference/builtin-types/integral-numeric-types.md): `byte`, `ushort`, `uint`, `ulong` - - [Unicode characters](/dotnet/standard/base-types/character-encoding-introduction): `char`, which represents a UTF-16 code unit + - [Unicode characters](../../standard/base-types/character-encoding-introduction.md): `char`, which represents a UTF-16 code unit - [IEEE binary floating-point](../language-reference/builtin-types/floating-point-numeric-types.md): `float`, `double` - [High-precision decimal floating-point](../language-reference/builtin-types/floating-point-numeric-types.md): `decimal` - Boolean: `bool`, which represents Boolean values—values that are either `true` or `false` @@ -55,13 +55,13 @@ The following outline provides an overview of C#'s type system. - [Reference types](../language-reference/keywords/reference-types.md) - [Class types](../language-reference/keywords/class.md) - Ultimate base class of all other types: `object` - - [Unicode strings](/dotnet/standard/base-types/character-encoding-introduction): `string`, which represents a sequence of UTF-16 code units + - [Unicode strings](../../standard/base-types/character-encoding-introduction.md): `string`, which represents a sequence of UTF-16 code units - User-defined types of the form `class C {...}` - [Interface types](../language-reference/keywords/interface.md) - User-defined types of the form `interface I {...}` - [Array types](../programming-guide/arrays/index.md) - Single- and multi-dimensional and jagged, for example, `int[]`, `int[,]`, and `int[][]` - - [Delegate types](../language-reference/keywords/delegate.md) + - [Delegate types](../language-reference/builtin-types/reference-types.md) - User-defined types of the form `delegate int D(...)` C# programs use *type declarations* to create new types. A type declaration specifies the name and the members of the new type. Five of C#'s categories of types are user-definable: class types, struct types, interface types, enum types, and delegate types. diff --git a/docs/csharp/whats-new/version-update-considerations.md b/docs/csharp/whats-new/version-update-considerations.md index c16625444ed58..ef1ab7f60dd20 100644 --- a/docs/csharp/whats-new/version-update-considerations.md +++ b/docs/csharp/whats-new/version-update-considerations.md @@ -58,4 +58,4 @@ New code: public double CalculateSquare(in double value) => value * value; ``` -The [What's new](index.md) articles note if introducing a feature that affects public declarations is source compatible or binary compatible. +The [What's new](csharp-8.md) articles note if introducing a feature that affects public declarations is source compatible or binary compatible. diff --git a/docs/framework/wcf/feature-details/security-considerations-for-data.md b/docs/framework/wcf/feature-details/security-considerations-for-data.md index 6040a66e87d08..df988a87c6850 100644 --- a/docs/framework/wcf/feature-details/security-considerations-for-data.md +++ b/docs/framework/wcf/feature-details/security-considerations-for-data.md @@ -282,7 +282,7 @@ This situation can be avoided by being aware of the following points: The is a serialization engine that uses tight coupling to types. This is similar to the and the . That is, it determines which type to instantiate by reading the .NET Framework assembly and type name from the incoming data. Although it is a part of WCF, there is no supplied way of plugging in this serialization engine; custom code must be written. The `NetDataContractSerializer` is provided primarily to ease migration from .NET Framework remoting to WCF. For more information, see the relevant section in [Serialization and Deserialization](serialization-and-deserialization.md). -Because the message itself may indicate any type can be loaded, the mechanism is inherently insecure and should be used only with trusted data. For more information, see the [BinaryFormatter security guide](/dotnet/standard/serialization/binaryformatter-security-guide). +Because the message itself may indicate any type can be loaded, the mechanism is inherently insecure and should be used only with trusted data. For more information, see the [BinaryFormatter security guide](../../../standard/serialization/binaryformatter-security-guide.md). Even when used with trusted data, the incoming data may insufficiently specify the type to load, especially if the property is set to . Anyone with access to the application’s directory or to the global assembly cache can substitute a malicious type in place of the one that is supposed to load. Always ensure the security of your application’s directory and of the global assembly cache by correctly setting permissions. diff --git a/docs/framework/wcf/feature-details/serialization-and-deserialization.md b/docs/framework/wcf/feature-details/serialization-and-deserialization.md index c21b32a7db6e7..7bd03398c8d79 100644 --- a/docs/framework/wcf/feature-details/serialization-and-deserialization.md +++ b/docs/framework/wcf/feature-details/serialization-and-deserialization.md @@ -16,7 +16,7 @@ Windows Communication Foundation (WCF) includes a new serialization engine, the WCF also includes a companion serializer, the . The : -* Is ***not*** secure. For more information, see the [BinaryFormatter security guide](/dotnet/standard/serialization/binaryformatter-security-guide). +* Is ***not*** secure. For more information, see the [BinaryFormatter security guide](../../../standard/serialization/binaryformatter-security-guide.md). * Is similar to the and serializers because it also emits .NET Framework type names as part of the serialized data. * Is used when the same types are shared on the serializing and the deserializing ends. diff --git a/docs/samples-and-tutorials/index.md b/docs/samples-and-tutorials/index.md index 59820f82320f6..3052a41fc8e0c 100644 --- a/docs/samples-and-tutorials/index.md +++ b/docs/samples-and-tutorials/index.md @@ -78,7 +78,7 @@ This tutorial demonstrates web communications, JSON serialization, and object-or This tutorial demonstrates many of the features of LINQ and the language elements that support it. The [completed sample](https://github.com/dotnet/samples/tree/master/csharp/getting-started/console-linq) is available in the dotnet/samples repository on GitHub. -**[Getting started with .NET Core on macOS using Visual Studio for Mac](../core/tutorials/using-on-mac-vs.md)** +**[Getting started with .NET Core on macOS using Visual Studio for Mac](../core/tutorials/with-visual-studio-mac.md)** This tutorial shows you how to build a simple .NET Core console app using Visual Studio for Mac. diff --git a/docs/welcome.md b/docs/welcome.md index dad40f7ad4309..86e5e8e625eaf 100644 --- a/docs/welcome.md +++ b/docs/welcome.md @@ -29,7 +29,7 @@ For information about the latest features added to the .NET implementations and - [What's new in .NET Core 3.1](core/whats-new/dotnet-core-3-1.md) - [What's new in the .NET Framework](framework/whats-new/index.md) -- [What's new in C#](csharp/whats-new/index.md) +- [What's new in C#](csharp/whats-new/csharp-8.md) - [What's new for Visual Basic](visual-basic/getting-started/whats-new.md) ## Documentation diff --git a/docs/whats-new/2020-07.md b/docs/whats-new/2020-07.md index fd5bc103dca45..3a485d11b04ce 100644 --- a/docs/whats-new/2020-07.md +++ b/docs/whats-new/2020-07.md @@ -12,36 +12,36 @@ Welcome to what's new in the .NET docs from July 2020. This article lists some o ### New articles -- [Serialization breaking changes](/dotnet/core/compatibility/serialization) - Deserialize rewraps exceptions -- [Debug a deadlock in .NET Core](/dotnet/core/diagnostics/debug-deadlock) - New docs for debugging deadlock and high CPU usage -- [Debug high CPU usage in .NET Core](/dotnet/core/diagnostics/debug-highcpu) - New docs for debugging deadlock and high CPU usage -- [Install .NET Core on Windows, Linux, and macOS](/dotnet/core/install/index) - Split Runtime/SDK pages into OS specific (to match linux design) -- [Install .NET Core on macOS](/dotnet/core/install/macos) - Split Runtime/SDK pages into OS specific (to match linux design) -- [Install .NET Core on Windows](/dotnet/core/install/windows) - Split Runtime/SDK pages into OS specific (to match linux design) +- [Serialization breaking changes](../core/compatibility/serialization.md) - Deserialize rewraps exceptions +- [Debug a deadlock in .NET Core](../core/diagnostics/debug-deadlock.md) - New docs for debugging deadlock and high CPU usage +- [Debug high CPU usage in .NET Core](../core/diagnostics/debug-highcpu.md) - New docs for debugging deadlock and high CPU usage +- [Install .NET Core on Windows, Linux, and macOS](../core/install/index.yml) - Split Runtime/SDK pages into OS specific (to match linux design) +- [Install .NET Core on macOS](../core/install/macos.md) - Split Runtime/SDK pages into OS specific (to match linux design) +- [Install .NET Core on Windows](../core/install/windows.md) - Split Runtime/SDK pages into OS specific (to match linux design) ## C# language ### New articles -- [Tuple types (C# reference)](/dotnet/csharp/language-reference/builtin-types/value-tuples) - Moved and revised the article about C# tuples +- [Tuple types (C# reference)](../csharp/language-reference/builtin-types/value-tuples.md) - Moved and revised the article about C# tuples ## .NET Framework ### New articles -- [DataSet and DataTable security guidance](/dotnet/framework/data/adonet/dataset-datatable-dataview/security-guidance) - DataSet security guidance +- [DataSet and DataTable security guidance](../framework/data/adonet/dataset-datatable-dataview/security-guidance.md) - DataSet security guidance ## .NET ### New articles - [Choosing between anonymous and tuple types](/dotnet/standard/design-guidelines/choosing-between-anonymous-and-tuple) - Choosing between anonymous and tuple types -- [Cross-Platform Cryptography in .NET Core and .NET 5](/dotnet/standard/security/cross-platform-cryptography) - Cross-plat cryptography article -- [BinaryFormatter security guide](/dotnet/standard/serialization/binaryformatter-security-guide) - Ra off binary formatter +- [Cross-Platform Cryptography in .NET Core and .NET 5](../standard/security/cross-platform-cryptography.md) - Cross-plat cryptography article +- [BinaryFormatter security guide](../standard/serialization/binaryformatter-security-guide.md) - Ra off binary formatter ### Updated articles -- [Chaining tasks using continuation tasks](/dotnet/standard/parallel-programming/chaining-tasks-by-using-continuation-tasks) - Address concerns about chaining tasks and lacking continuation examples with .Unwrap() +- [Chaining tasks using continuation tasks](../standard/parallel-programming/chaining-tasks-by-using-continuation-tasks.md) - Address concerns about chaining tasks and lacking continuation examples with .Unwrap() ## Community contributors diff --git a/docs/whats-new/dotnet-2020-05.md b/docs/whats-new/dotnet-2020-05.md index 6bc3caa794e57..b5d5f31e398f6 100644 --- a/docs/whats-new/dotnet-2020-05.md +++ b/docs/whats-new/dotnet-2020-05.md @@ -23,7 +23,7 @@ Welcome to what's new in .NET docs for May 2020. This article lists some of the ### New articles - [CentOS 8 Package Manager - Install .NET Core](../core/install/linux-package-manager-centos8.md) - Add install instructions for CentOS 8 -- [Fedora 32 Package Manager - Install .NET Core](../core/install/linux-package-manager-fedora32.md) - Add installation instructions for Fedora 32 +- [Fedora 32 Package Manager - Install .NET Core](../core/install/linux-fedora.md) - Add installation instructions for Fedora 32 - [Ubuntu Package Manager - Install .NET Core](../core/install/linux-ubuntu.md) - Ubuntu install article - [How to remove the .NET Core Runtime and SDK](../core/install/remove-runtime-sdk-versions.md) - Update and move core uninstall article to install area - [Manage .NET project and item templates](../core/install/templates.md) - New article around .NET Core template management and old SDK templates From b6e48efe48e581d6cdc5da963d696c1958f59305 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Mon, 17 Aug 2020 13:11:31 -0700 Subject: [PATCH 2/3] link fix ups --- docs/csharp/tour-of-csharp/index.md | 2 +- docs/csharp/whats-new/version-update-considerations.md | 2 +- docs/welcome.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/csharp/tour-of-csharp/index.md b/docs/csharp/tour-of-csharp/index.md index 9eefdd795e293..357dc0e79ef30 100644 --- a/docs/csharp/tour-of-csharp/index.md +++ b/docs/csharp/tour-of-csharp/index.md @@ -61,7 +61,7 @@ The following outline provides an overview of C#'s type system. - User-defined types of the form `interface I {...}` - [Array types](../programming-guide/arrays/index.md) - Single- and multi-dimensional and jagged, for example, `int[]`, `int[,]`, and `int[][]` - - [Delegate types](../language-reference/builtin-types/reference-types.md) + - [Delegate types](../language-reference/builtin-types/reference-types.md#the-delegate-type) - User-defined types of the form `delegate int D(...)` C# programs use *type declarations* to create new types. A type declaration specifies the name and the members of the new type. Five of C#'s categories of types are user-definable: class types, struct types, interface types, enum types, and delegate types. diff --git a/docs/csharp/whats-new/version-update-considerations.md b/docs/csharp/whats-new/version-update-considerations.md index ef1ab7f60dd20..c16625444ed58 100644 --- a/docs/csharp/whats-new/version-update-considerations.md +++ b/docs/csharp/whats-new/version-update-considerations.md @@ -58,4 +58,4 @@ New code: public double CalculateSquare(in double value) => value * value; ``` -The [What's new](csharp-8.md) articles note if introducing a feature that affects public declarations is source compatible or binary compatible. +The [What's new](index.md) articles note if introducing a feature that affects public declarations is source compatible or binary compatible. diff --git a/docs/welcome.md b/docs/welcome.md index 86e5e8e625eaf..dad40f7ad4309 100644 --- a/docs/welcome.md +++ b/docs/welcome.md @@ -29,7 +29,7 @@ For information about the latest features added to the .NET implementations and - [What's new in .NET Core 3.1](core/whats-new/dotnet-core-3-1.md) - [What's new in the .NET Framework](framework/whats-new/index.md) -- [What's new in C#](csharp/whats-new/csharp-8.md) +- [What's new in C#](csharp/whats-new/index.md) - [What's new for Visual Basic](visual-basic/getting-started/whats-new.md) ## Documentation From 36ab6b8fcef6f6ff9568cf673c8f3c44c4ff42ec Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Tue, 18 Aug 2020 14:39:51 -0700 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: Youssef Victor <31348972+Youssef1313@users.noreply.github.com> --- docs/core/get-started.md | 2 +- docs/core/install/macos-notarization-issues.md | 2 +- docs/samples-and-tutorials/index.md | 2 +- docs/whats-new/dotnet-2020-05.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/core/get-started.md b/docs/core/get-started.md index 926ef5fe524a9..f3c4cb018303e 100644 --- a/docs/core/get-started.md +++ b/docs/core/get-started.md @@ -68,7 +68,7 @@ Get started developing .NET Core applications by following these step-by-step tu - [Get started with .NET Core on macOS using Visual Studio Code](./tutorials/using-on-macos.md) - [Get started with .NET Core using the command-line](./tutorials/cli-create-console-app.md) -- [Get started with .NET Core on macOS using Visual Studio for Mac](tutorials/with-visual-studio-mac.md) +- [Tutorial: Create a .NET Core console application using Visual Studio for Mac](tutorials/with-visual-studio-mac.md) - [Build a .NET Standard library on macOS using Visual Studio for Mac](tutorials/library-with-visual-studio-mac.md) | | | diff --git a/docs/core/install/macos-notarization-issues.md b/docs/core/install/macos-notarization-issues.md index 92e1ff64a49bc..e373332fb8f68 100644 --- a/docs/core/install/macos-notarization-issues.md +++ b/docs/core/install/macos-notarization-issues.md @@ -87,5 +87,5 @@ If you want your application to run on macOS Catalina (version 10.15) or higher, ## Next steps -- [.NET Core dependencies and requirements](windows.md). +- [.NET Core dependencies and requirements](macos.md#dependencies). - [Install the .NET Core Runtime and SDK](macos.md). diff --git a/docs/samples-and-tutorials/index.md b/docs/samples-and-tutorials/index.md index 3052a41fc8e0c..c4873a76bd2f9 100644 --- a/docs/samples-and-tutorials/index.md +++ b/docs/samples-and-tutorials/index.md @@ -78,7 +78,7 @@ This tutorial demonstrates web communications, JSON serialization, and object-or This tutorial demonstrates many of the features of LINQ and the language elements that support it. The [completed sample](https://github.com/dotnet/samples/tree/master/csharp/getting-started/console-linq) is available in the dotnet/samples repository on GitHub. -**[Getting started with .NET Core on macOS using Visual Studio for Mac](../core/tutorials/with-visual-studio-mac.md)** +**[Tutorial: Create a .NET Core console application using Visual Studio for Mac](../core/tutorials/with-visual-studio-mac.md)** This tutorial shows you how to build a simple .NET Core console app using Visual Studio for Mac. diff --git a/docs/whats-new/dotnet-2020-05.md b/docs/whats-new/dotnet-2020-05.md index b5d5f31e398f6..e24333c262efe 100644 --- a/docs/whats-new/dotnet-2020-05.md +++ b/docs/whats-new/dotnet-2020-05.md @@ -23,7 +23,7 @@ Welcome to what's new in .NET docs for May 2020. This article lists some of the ### New articles - [CentOS 8 Package Manager - Install .NET Core](../core/install/linux-package-manager-centos8.md) - Add install instructions for CentOS 8 -- [Fedora 32 Package Manager - Install .NET Core](../core/install/linux-fedora.md) - Add installation instructions for Fedora 32 +- Fedora 32 Package Manager - Install .NET Core - [Ubuntu Package Manager - Install .NET Core](../core/install/linux-ubuntu.md) - Ubuntu install article - [How to remove the .NET Core Runtime and SDK](../core/install/remove-runtime-sdk-versions.md) - Update and move core uninstall article to install area - [Manage .NET project and item templates](../core/install/templates.md) - New article around .NET Core template management and old SDK templates