Merge pull request #3576 from MicrosoftDocs/main637745856831611491

Repo sync for protected CLA branch

Author: Colin Robertson

.openpublishing.redirection.json

@@ -1360,11 +1360,6 @@
       "redirect_url": "/cpp/get-started/tutorial-console-cpp",
       "redirect_document_id": false
     },
-    {
-      "source_path": "docs/get-started/index.yml",
-      "redirect_url": "/cpp/get-started/tutorial-console-cpp",
-      "redirect_document_id": false
-    },
     {
       "source_path": "docs/ide/adding-references-in-visual-cpp-projects.md",
       "redirect_url": "/cpp/build/adding-references-in-visual-cpp-projects",

docs/cpp/member-access-operators-dot-and.md

@@ -1,29 +1,28 @@
 ---
-description: "Learn more about: Member Access Operators: . and ->"
-title: "Member Access Operators: . and ->"
-ms.date: "11/04/2016"
+description: "Learn more about: Member access operators: '.' and '->'"
+title: "Member access operators: '.' and '->'"
+ms.date: 12/04/2021
 f1_keywords: [".", "->"]
 helpviewer_keywords: ["member access, expressions", "operators [C++], member access", "dot operator (.)", "-> operator", "member access, operators", "postfix operators [C++]", ". operator", "member access"]
 ms.assetid: f8fc3df9-d728-40c5-b384-276927f5f1b3
 ---
-# Member Access Operators: `.` and `->`
+# Member access operators: `.` and `->`
 
 ## Syntax
 
-```
-postfix-expression . name
-postfix-expression -> name
-```
+*`postfix-expression`*:\
+&emsp; *`postfix-expression`* **`.`** **`template`**<sub>opt</sub> *`id-expression`*\
+&emsp; *`postfix-expression`* **`->`** **`template`**<sub>opt</sub> *`id-expression`*
 
 ## Remarks
 
-The member access operators **.** and **->** are used to refer to members of structures, unions, and classes. Member access expressions have the value and type of the selected member.
+The member access operators **`.`** and **`->`** are used to refer to members of `struct`, `union`, and `class` types. Member access expressions have the value and type of the selected member.
 
 There are two forms of member access expressions:
 
-1. In the first form, *postfix-expression* represents a value of struct, class, or union type, and *name* names a member of the specified structure, union, or class. The value of the operation is that of *name* and is an l-value if *postfix-expression* is an l-value.
+1. In the first form, *`postfix-expression`* represents a value of `struct`, `class`, or `union` type, and *`id-expression`* names a member of the specified `struct`, `union`, or `class`. The value of the operation is that of *`id-expression`* and is an l-value if *`postfix-expression`* is an l-value.
 
-1. In the second form, *postfix-expression* represents a pointer to a structure, union, or class, and *name* names a member of the specified structure, union, or class. The value is that of *name* and is an l-value. The **->** operator dereferences the pointer. Therefore, the expressions `e->member` and `(*e).member` (where *e* represents a pointer) yield identical results (except when the operators **->** or <strong>\*</strong> are overloaded).
+1. In the second form, *`postfix-expression`* represents a pointer to a `struct`, `union`, or `class`, and *`id-expression`* names a member of the specified `struct`, `union`, or `class`. The value is that of `id-expression` and is an l-value. The **`->`** operator dereferences the pointer. The expressions `e->member` and `(*(e)).member` (where *`e`* represents a pointer) yield identical results (except when the operators **`->`** or **`*`** are overloaded).
 
 ## Example
 
@@ -63,7 +62,7 @@ int main() {
 
 ## See also
 
-[Postfix Expressions](../cpp/postfix-expressions.md)<br/>
-[C++ Built-in Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)<br/>
-[Classes and Structs](../cpp/classes-and-structs-cpp.md)<br/>
-[Structure and Union Members](../c-language/structure-and-union-members.md)
+[Postfix expressions](../cpp/postfix-expressions.md)\
+[C++ built-in operators, precedence, and associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)\
+[Classes and Structs](../cpp/classes-and-structs-cpp.md)\
+[Structure and union members](../c-language/structure-and-union-members.md)

docs/cpp/pointer-to-member-operators-dot-star-and-star.md

@@ -1,23 +1,23 @@
 ---
-description: "Learn more about: Pointer-to-Member Operators: .* and ->*"
-title: "Pointer-to-Member Operators: .* and ->*"
-ms.date: "11/04/2016"
+description: "Learn more about: Pointer-to-member operators: '.*' and '->*'"
+title: "Pointer-to-member operators: '.*' and '->*'"
+ms.date: 12/04/2021
 f1_keywords: [".*", "->*"]
 helpviewer_keywords: ["expressions [C++], pointer", "pointer-to-member operators [C++]", ".* operator", "expressions [C++], operators", "->* operator"]
 ms.assetid: 2632be3f-1c81-4523-b56c-982a92a68688
 ---
-# Pointer-to-Member Operators: `.*` and `->*`
+# Pointer-to-member operators: `.*` and `->*`
 
 ## Syntax
 
-```
-expression .* expression
-expression ->* expression
-```
+*`pm-expression`*:\
+  *`cast-expression`*\
+  *`pm-expression`* **`.*`** *`cast-expression`*\
+  *`pm-expression`* **`->*`** *`cast-expression`*
 
 ## Remarks
 
-The pointer-to-member operators, .* and ->\*, return the value of a specific class member for the object specified on the left side of the expression.  The right side must specify a member of the class.  The following example shows how to use these operators:
+The pointer-to-member operators **`.*`** and **`->*`** return the value of a specific class member for the object specified on the left side of the expression.  The right side must specify a member of the class.  The following example shows how to use these operators:
 
 ```cpp
 // expre_Expressions_with_Pointer_Member_Operators.cpp
@@ -68,13 +68,13 @@ m_func1
 
 In the preceding example, a pointer to a member, `pmfn`, is used to invoke the member function `m_func1`. Another pointer to a member, `pmd`, is used to access the `m_num` member.
 
-The binary operator .* combines its first operand, which must be an object of class type, with its second operand, which must be a pointer-to-member type.
+The binary operator **`.*`** combines its first operand, which must be an object of class type, with its second operand, which must be a pointer-to-member type.
 
-The binary operator ->* combines its first operand, which must be a pointer to an object of class type, with its second operand, which must be a pointer-to-member type.
+The binary operator **`->*`** combines its first operand, which must be a pointer to an object of class type, with its second operand, which must be a pointer-to-member type.
 
-In an expression containing the .* operator, the first operand must be of the class type of, and be accessible to, the pointer to member specified in the second operand or of an accessible type unambiguously derived from and accessible to that class.
+In an expression containing the **`.*`** operator, the first operand must be of the class type of, and be accessible to, the pointer to member specified in the second operand or of an accessible type unambiguously derived from and accessible to that class.
 
-In an expression containing the ->* operator, the first operand must be of the type "pointer to the class type" of the type specified in the second operand, or it must be of a type unambiguously derived from that class.
+In an expression containing the **`->*`** operator, the first operand must be of the type "pointer to the class type" of the type specified in the second operand, or it must be of a type unambiguously derived from that class.
 
 ## Example
 
@@ -116,11 +116,11 @@ int main() {
 }
 ```
 
-The result of the .* or ->\* pointer-to-member operators is an object or function of the type specified in the declaration of the pointer to member. So, in the preceding example, the result of the expression `ADerived.*pmfnFunc1()` is a pointer to a function that returns void. This result is an l-value if the second operand is an l-value.
+The result of the **`.*`** or **`->*`** pointer-to-member operators is an object or function of the type specified in the declaration of the pointer to member. So, in the preceding example, the result of the expression `ADerived.*pmfnFunc1()` is a pointer to a function that returns `void`. This result is an l-value if the second operand is an l-value.
 
 > [!NOTE]
 > If the result of one of the pointer-to-member operators is a function, then the result can be used only as an operand to the function call operator.
 
 ## See also
 
-[C++ Built-in Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)
+[C++ built-in operators, precedence, and associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)

docs/get-started/includes/git-source-control.md

@@ -0,0 +1,42 @@
+---
+ms.date: 12/06/2021
+ms.custom: vs-get-started
+ms.topic: include
+---
+::: moniker range=">=msvc-160"
+
+## Add Git source control
+
+Now that you've created an app, you might want to add it to a Git repository. We've got you covered. Visual Studio makes that process easy with Git tools you can use directly from the IDE.
+
+> [!TIP]
+> Git is the most widely used modern version control system, so whether you're a professional developer or you're learning how to code, Git can be very useful. If you're new to Git, the [https://git-scm.com/](https://git-scm.com/) website is a good place to start. There, you can find cheat sheets, a popular online book, and Git Basics videos.
+
+To associate your code with Git, you start by creating a new Git repository where your code is located. Here's how:
+
+1. In the status bar at the bottom-right corner of Visual Studio, select **Add to Source Control**, and then select **Git**.
+
+    :::image type="content" source="../media/vs-2022/git-add-source-control.png" alt-text="Screenshot of the Git source control buttons below the Solution Explorer pane, with the Add to Source Control button highlighted.":::
+
+1. In the **Create a Git repository** dialog box, sign in to GitHub.
+
+    :::image type="content" source="../media/vs-2022/git-create-repo.png" alt-text="Screenshot of the Create a Git Repository dialog window where you can sign in to GitHub.":::
+
+    The repository name auto-populates based on your folder location. By default, your new repository is private, which means you're the only one who can access it.
+
+    > [!TIP]
+    > Whether your repository is public or private, it's best to have a remote backup of your code stored securely on GitHub. Even if you aren't working with a team, a remote repository makes your code available to you from any computer.
+
+1. Select **Create and Push**.
+
+    After you create your repository, you see status details in the status bar.
+
+    :::image type="content" source="../media/vs-2022/git-new-private-repo-status-details.png" alt-text="Screenshot of the repo status bar that's below the Solution Explorer pane in Visual Studio.":::
+
+    The first icon with the arrows shows how many outgoing/incoming commits are in your current branch. You can use this icon to pull any incoming commits or push any outgoing commits. You can also choose to view these commits first. To do so, select the icon, and then select **View Outgoing/Incoming**.
+
+    The second icon with the pencil shows the number of uncommitted changes to your code. You can select this icon to view those changes in the **Git Changes** window.
+
+To learn more about how to use Git with your app, see the [Visual Studio version control documentation](/visualstudio/version-control/).
+
+::: moniker-end

docs/get-started/index.yml

@@ -0,0 +1,89 @@
+### YamlMime:Landing
+
+title: Visual Studio tutorials | C++ 
+summary: Create C++ apps with Visual Studio.
+
+metadata:
+  title: C++ development with Visual Studio
+  description: Create C++ apps by using Visual Studio.
+  ms.custom: vs-acquisition
+  ms.topic: landing-page
+  ms.date: 12/06/2021
+  author: corob-msft
+  ms.author: corob 
+  manager: markl
+  ms.prod: visual-cpp
+  ms.technology: vs-acquisition  
+  dev_langs:
+    - C++
+
+# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | whats-new
+
+landingContent: 
+  # Card
+  - title: Get started
+    linkLists:
+      - linkListType: how-to-guide
+        links:
+          - text: Install C++ support in Visual Studio
+            url: ../build/vscpp-step-0-installation.md
+      - linkListType: get-started
+        links:
+          - text: Start a guided tour of Visual Studio
+            url: /visualstudio/get-started/visual-studio-ide
+      - linkListType: quickstart
+        links:
+          - text: Create a "Hello World" console app
+            url: ../build/vscpp-step-1-create.md
+          - text: Build and run your "Hello World" console app
+            url: ../build/vscpp-step-2-build.md
+      - linkListType: overview
+        links:
+          - text: Learn about the Modern C++ language
+            url: ../cpp/welcome-back-to-cpp-modern-cpp.md
+
+  # Card
+  - title: Create C and C++ apps in Visual Studio
+    linkLists:
+      - linkListType: tutorial
+        links:
+          - text: Create a console app
+            url: tutorial-console-cpp.md
+          - text: Create a Universal Windows Platform app 
+            url: /windows/uwp/cpp-and-winrt-apis/get-started
+          - text: Create a Windows Desktop app
+            url: /windows/desktop/learnwin32/learn-to-program-for-windows
+          - text: Create a Windows Desktop app with MFC
+            url: ../mfc/reference/creating-an-mfc-application.md
+          - text: Create a Windows DLL
+            url: ../build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md
+          - text: Create a static library
+            url: ../build/walkthrough-creating-and-using-a-static-library-cpp.md
+          - text: Create a .NET component
+            url: ../dotnet/walkthrough-compiling-a-cpp-program-that-targets-the-clr-in-visual-studio.md
+          - text: Create a DirectX game
+            url: /windows/uwp/gaming/tutorial--create-your-first-uwp-directx-game
+
+  # Card
+  - title: Learn Visual Studio
+    linkLists:
+      - linkListType: tutorial
+        links:
+          - text: Open code from a repo
+            url: /visualstudio/get-started/tutorial-open-project-from-repo.md
+          - text: Write and edit code 
+            url: /visualstudio/get-started/tutorial-editor.md
+          - text: Compile and build 
+            url: /visualstudio/ide/compiling-and-building-in-visual-studio.md
+          - text: Debug your C++ code
+            url: /visualstudio/debugger/quickstart-debug-with-cplusplus
+          - text: Test your C++ code
+            url: /visualstudio/test/writing-unit-tests-for-c-cpp
+          - text: Compile C++ on the command line
+            url: ../build/walkthrough-compiling-a-native-cpp-program-on-the-command-line.md
+          - text: Compile C on the command line
+            url: ../build/walkthrough-compile-a-c-program-on-the-command-line.md
+          - text: Compile C++/CX on the command line
+            url: ../build/walkthrough-compiling-a-cpp-cx-program-on-the-command-line.md
+          - text: Compile C++/CLI on the command line
+            url: ../build/walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md

docs/get-started/media/vs-2022/git-add-source-control.png

@@ -0,0 +1,62 @@
+items: 
+- name: Get started with Visual C++
+  expanded: true
+  items:
+    - name: Install C++ support in Visual Studio
+      href: ../build/vscpp-step-0-installation.md
+    - name: Visual Studio guided tour
+      href: /visualstudio/get-started/visual-studio-ide
+    - name: Create and edit a C++ console app project
+      href: ../build/vscpp-step-1-create.md
+    - name: Build and run a C++ console app project
+      href: ../build/vscpp-step-2-build.md
+    - name: Welcome to Modern C++
+      href: ../cpp/welcome-back-to-cpp-modern-cpp.md
+    - name: Create a console calculator in C++
+      href: ../get-started/tutorial-console-cpp.md
+    - name: Create a UWP app
+      href: /windows/uwp/cpp-and-winrt-apis/get-started
+    - name: Create a Windows Desktop application
+      href: /windows/desktop/learnwin32/learn-to-program-for-windows
+    - name: Create a DirectX game
+      href: /windows/uwp/gaming/tutorial--create-your-first-uwp-directx-game
+- name: Create C and C++ apps in Visual Studio
+  expanded: false
+  items:
+    - name: Create a console app
+      href: tutorial-console-cpp.md
+    - name: Create a Universal Windows Platform app 
+      href: /windows/uwp/cpp-and-winrt-apis/get-started
+    - name: Create a Windows Desktop app
+      href: /windows/desktop/learnwin32/learn-to-program-for-windows
+    - name: Create a Windows Desktop app with MFC
+      href: ../mfc/reference/creating-an-mfc-application.md
+    - name: Create a Windows DLL
+      href: ../build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md
+    - name: Create a static library
+      href: ../build/walkthrough-creating-and-using-a-static-library-cpp.md
+    - name: Create a .NET component
+      href: ../dotnet/walkthrough-compiling-a-cpp-program-that-targets-the-clr-in-visual-studio.md
+    - name: Create a DirectX game
+      href: /windows/uwp/gaming/tutorial--create-your-first-uwp-directx-game
+- name: Learn Visual Studio
+  expanded: false
+  items:
+    - name: Open code from a repo
+      href: /visualstudio/get-started/tutorial-open-project-from-repo.md
+    - name: Write and edit code 
+      href: /visualstudio/get-started/tutorial-editor.md
+    - name: Compile and build 
+      href: /visualstudio/ide/compiling-and-building-in-visual-studio.md
+    - name: Debug your C++ code
+      href: /visualstudio/debugger/quickstart-debug-with-cplusplus
+    - name: Test your C++ code
+      href: /visualstudio/test/writing-unit-tests-for-c-cpp
+    - name: Compile C++ on the command line
+      href: ../build/walkthrough-compiling-a-native-cpp-program-on-the-command-line.md
+    - name: Compile C on the command line
+      href: ../build/walkthrough-compile-a-c-program-on-the-command-line.md
+    - name: Compile C++/CX on the command line
+      href: ../build/walkthrough-compiling-a-cpp-cx-program-on-the-command-line.md
+    - name: Compile C++/CLI on the command line
+      href: ../build/walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md