Skip to content

Commit 1e02254

Browse files
gewarrenYoussef1313mairaw
authored
Style guide-ish improvements (#16419)
* Style guide-ish improvements * Apply suggestions from Youssef * Add .NET Standard link * Apply suggestions from Maira Co-authored-by: Youssef Victor <[email protected]> Co-authored-by: Maira Wenzel <[email protected]>
1 parent 58ffece commit 1e02254

File tree

2 files changed

+38
-38
lines changed

2 files changed

+38
-38
lines changed

docs/standard/get-started.md

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,33 @@
11
---
2-
title: Get Started with .NET
2+
title: Get started with .NET
33
description: Lists various articles for getting started with .NET, both from a language and platform perspective.
44
author: cartermp
55
ms.author: mairaw
6-
ms.date: 05/01/2017
6+
ms.date: 01/21/2020
77
ms.technology: dotnet-standard
88
ms.assetid: 81c07080-acdf-4aef-a66d-0ab52fab2c04
99
---
10-
# Get Started
10+
# Get started
1111

12-
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.
12+
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.
1313

1414
## Get started using .NET languages
1515

16-
* 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.
16+
* 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.
1717

18-
* 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.
18+
* 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.
1919

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

2222
## Get started using .NET Core
2323

24-
* [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.
24+
* [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.
2525

26-
* 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.
26+
* 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.
27+
28+
## Get started using .NET Standard
29+
30+
* For an introductory tutorial, see [Build a .NET Standard library in Visual Studio](../core/tutorials/library-with-visual-studio.md).
2731

2832
## Get started using .NET Core on Docker
2933

docs/standard/index.md

Lines changed: 25 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,56 @@
11
---
2-
title: .NET Guide
3-
description: Learn about .NET.
2+
title: .NET guide
3+
description: Learn about .NET and .NET Standard.
44
author: cartermp
5-
ms.date: 05/02/2017
5+
ms.date: 12/27/2019
66
ms.technology: dotnet-standard
77
ms.assetid: bbfe6465-329d-4982-869d-472e7ef85d93
88
---
9-
# .NET Guide
9+
# .NET guide
1010

11-
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.
11+
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).
1212

1313
## New to .NET
1414

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

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

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

21-
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.
21+
For an overview of the various pieces of .NET and how they fit together, see [.NET architectural components](components.md).
2222

2323
## New to .NET Core
2424

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

2727
## New to .NET Standard
2828

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

31-
## Porting .NET Framework Code to .NET Core
31+
## Port .NET Framework code to .NET Standard or .NET Core
3232

33-
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).
33+
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.
3434

35-
## Porting a NuGet package from .NET Framework to .NET Standard or .NET Core
35+
## .NET concepts
3636

37-
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.
37+
For more information about the major concepts of .NET, see:
3838

39-
## Interested in Major .NET Concepts
40-
41-
If you're interested in some of the major concepts of .NET, check out:
42-
43-
* [.NET Architectural Components](components.md)
39+
* [.NET architectural components](components.md)
4440
* [.NET Standard](net-standard.md)
45-
* [Native Interoperability](native-interop/index.md)
46-
* [Garbage Collection](garbage-collection/index.md)
47-
* [Base Types in .NET](base-types/index.md)
41+
* [Native interoperability](native-interop/index.md)
42+
* [Garbage collection](garbage-collection/index.md)
43+
* [Base types in .NET](base-types/index.md)
4844
* [Collections](collections/index.md)
4945
* [Dates, times, and time zones](datetime/index.md)
50-
* [Asynchronous Programming](async.md)
46+
* [Asynchronous programming](async.md)
5147

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

54-
* [C# Guide](../csharp/index.yml)
55-
* [F# Guide](../fsharp/index.yml)
56-
* [Visual Basic Guide](../visual-basic/index.yml)
50+
* [C# guide](../csharp/index.yml)
51+
* [F# guide](../fsharp/index.yml)
52+
* [Visual Basic guide](../visual-basic/index.yml)
5753

58-
## API Reference
54+
## API reference
5955

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

0 commit comments

Comments
 (0)