Skip to content

Style guide-ish improvements #16419

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Jan 21, 2020
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
22 changes: 13 additions & 9 deletions docs/standard/get-started.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,33 @@
---
title: Get Started with .NET
title: Get started with .NET
description: Lists various articles for getting started with .NET, both from a language and platform perspective.
author: cartermp
ms.author: mairaw
ms.date: 05/01/2017
ms.date: 01/21/2020
ms.technology: dotnet-standard
ms.assetid: 81c07080-acdf-4aef-a66d-0ab52fab2c04
---
# Get Started
# Get started

There are a number of ways to get started with .NET. Because .NET is a massive platform, there are multiple articles in this documentation which show how you can get started with .NET, each from a different perspective.
There are a number of ways to get started with .NET. Because .NET is a massive platform, there are multiple articles in this documentation that can help you get started with .NET, each from a different perspective.

## Get started using .NET languages

* The [C# Getting Started](../csharp/getting-started/index.md) articles and [C# Tutorials](../csharp/tutorials/index.md) provide a number of ways to get started in a C#-centric way.
* The [C# getting started](../csharp/getting-started/index.md) articles and [C# tutorials](../csharp/tutorials/index.md) provide ways to get started in a C#-centric way.

* The [F# Getting Started](../fsharp/get-started/index.md) tutorials provide three primary ways you can use F#: with Visual Studio, Visual Studio Code, or command-line tools.
* The [F# getting started](../fsharp/get-started/index.md) tutorials cover the three primary ways you can use F#: with Visual Studio, Visual Studio Code, or command-line tools.

* The [Visual Basic Getting Started](../visual-basic/getting-started/index.md) articles provide guides for using Visual Basic in Visual Studio.
* The [Visual Basic getting started](../visual-basic/getting-started/index.md) articles provide guides for using Visual Basic in Visual Studio.

## Get started using .NET Core

* [Getting Started with .NET Core](../core/get-started.md) provides an overview of articles which show how to get started with .NET Core on different operating systems and using different tools.
* [Get started with .NET Core](../core/get-started.md) provides an overview of articles that show how to get started with .NET Core on different operating systems and using different tools.

* The [.NET Core Tutorials](../core/tutorials/index.md) detail a number of ways you can get started with .NET Core using your operating system and tooling of choice.
* The [.NET Core tutorials](../core/tutorials/index.md) detail ways you can get started with .NET Core using your operating system and tooling of choice.

## Get started using .NET Standard

* For an introductory tutorial, see [Build a .NET Standard library in Visual Studio](../core/tutorials/library-with-visual-studio.md).

## Get started using .NET Core on Docker

Expand Down
54 changes: 25 additions & 29 deletions docs/standard/index.md
Original file line number Diff line number Diff line change
@@ -1,60 +1,56 @@
---
title: .NET Guide
description: Learn about .NET.
title: .NET guide
description: Learn about .NET and .NET Standard.
author: cartermp
ms.date: 05/02/2017
ms.date: 12/27/2019
ms.technology: dotnet-standard
ms.assetid: bbfe6465-329d-4982-869d-472e7ef85d93
---
# .NET Guide
# .NET guide

The .NET Guide provides a large amount of information about .NET. Depending on your familiarity with .NET, you may wish to explore different sections of this guide and other sections of the .NET documentation.
The .NET guide provides information about .NET. Depending on your familiarity with .NET, you may wish to explore different sections of this guide and other guides such as [.NET Core](../core/index.md) or [.NET Framework](../framework/index.md).

## New to .NET

If you want a high-level overview about .NET, check out [What is .NET?](https://dotnet.microsoft.com/learn/dotnet/what-is-dotnet).
If you want a high-level overview of .NET, see [What is .NET?](https://dotnet.microsoft.com/learn/dotnet/what-is-dotnet).

If you're new to .NET, check out the [Get Started](get-started.md) article.
If you're new to .NET, see [Get started](get-started.md).

If you prefer to have a guided tour through major features of .NET, check out the [Tour of .NET](tour.md).
If you prefer to have a guided tour through major features of .NET, see [Tour of .NET](tour.md).

You can also read about [.NET Architectural Components](components.md) to get an overview of the various "pieces" of .NET and how they fit together.
For an overview of the various pieces of .NET and how they fit together, see [.NET architectural components](components.md).

## New to .NET Core

If you're new to .NET Core, check out [Get Started with .NET Core](../core/get-started.md).
If you're new to .NET Core, check out [Get started with .NET Core](../core/get-started.md).

## New to .NET Standard

If you're new to .NET Standard, check out [.NET Standard](net-standard.md).

## Porting .NET Framework Code to .NET Core
## Port .NET Framework code to .NET Standard or .NET Core

If you're looking to port an application, service, or some component of a system to .NET Core, check out [Porting to .NET Core from .NET Framework](../core/porting/index.md).
To port an application, service, component, or NuGet package to .NET Standard or .NET Core, see [Port to .NET Core from .NET Framework](../core/porting/index.md). Tooling for .NET Standard and .NET Core is shared, so the content is relevant for porting to both frameworks.

## Porting a NuGet package from .NET Framework to .NET Standard or .NET Core
## .NET concepts

If you're looking to port a NuGet package to .NET Standard, check out [Porting to .NET Core from .NET Framework](../core/porting/index.md). Tooling for .NET Standard and .NET Core are shared, so the content will be relevant for porting to .NET Standard as well as .NET Core.
For more information about the major concepts of .NET, see:

## Interested in Major .NET Concepts

If you're interested in some of the major concepts of .NET, check out:

* [.NET Architectural Components](components.md)
* [.NET architectural components](components.md)
* [.NET Standard](net-standard.md)
* [Native Interoperability](native-interop/index.md)
* [Garbage Collection](garbage-collection/index.md)
* [Base Types in .NET](base-types/index.md)
* [Native interoperability](native-interop/index.md)
* [Garbage collection](garbage-collection/index.md)
* [Base types in .NET](base-types/index.md)
* [Collections](collections/index.md)
* [Dates, times, and time zones](datetime/index.md)
* [Asynchronous Programming](async.md)
* [Asynchronous programming](async.md)

Additionally, check out each language guide to learn about the three major .NET languages:
For information about the three major .NET languages, see:

* [C# Guide](../csharp/index.yml)
* [F# Guide](../fsharp/index.yml)
* [Visual Basic Guide](../visual-basic/index.yml)
* [C# guide](../csharp/index.yml)
* [F# guide](../fsharp/index.yml)
* [Visual Basic guide](../visual-basic/index.yml)

## API Reference
## API reference

Check out the [.NET API Reference](../../api/index.md) to see the breadth of APIs available.
For detailed information about all of the APIs that are available in .NET, see [.NET API reference](../../api/index.md).