Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/core/get-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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)
- [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)

| | |
Expand Down
2 changes: 1 addition & 1 deletion docs/core/install/macos-notarization-issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -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](macos.md#dependencies).
- [Install the .NET Core Runtime and SDK](macos.md).
2 changes: 1 addition & 1 deletion docs/core/tutorials/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down
6 changes: 3 additions & 3 deletions docs/csharp/tour-of-csharp/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`
Expand All @@ -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#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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -282,7 +282,7 @@ This situation can be avoided by being aware of the following points:

The <xref:System.Runtime.Serialization.NetDataContractSerializer> is a serialization engine that uses tight coupling to types. This is similar to the <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> and the <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter>. 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 <xref:System.Runtime.Serialization.NetDataContractSerializer> 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 <xref:System.Runtime.Serialization.NetDataContractSerializer> 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 <xref:System.Runtime.Serialization.NetDataContractSerializer.AssemblyFormat%2A> property is set to <xref:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle.Simple>. 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.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Windows Communication Foundation (WCF) includes a new serialization engine, the

WCF also includes a companion serializer, the <xref:System.Runtime.Serialization.NetDataContractSerializer>. The <xref:System.Runtime.Serialization.NetDataContractSerializer>:

* 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 <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> and <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> 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.

Expand Down
2 changes: 1 addition & 1 deletion docs/samples-and-tutorials/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)**
**[Tutorial: Create a .NET Core console application using Visual Studio for Mac](../core/tutorials/with-visual-studio-mac.md)**
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is another redirected link at the beginning:

Writing .NET Core console apps using the .NET Core CLI: A step-by-step guide

@gewarren Looks like the tool you're using missed it for some reason. The tool may have missed other redirections too.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I just reran the tool and it did catch that one. Not sure why it didn't catch it the first time. I'll merge this PR and rerun it.


This tutorial shows you how to build a simple .NET Core console app using Visual Studio for Mac.

Expand Down
22 changes: 11 additions & 11 deletions docs/whats-new/2020-07.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
2 changes: 1 addition & 1 deletion docs/whats-new/dotnet-2020-05.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
- [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
Expand Down