New Native Platform docs describing the cpp-lib template (#1032)

## Description

This PR creates new "Native Platform" docs to capture using the new `cpp-lib` template to add Windows support libraries for both Native Modules and Native Components. This PR also moves the existing "Native Module" docs to a "Legacy Docs" section on the sidebar - each is also given a link to direct devs toward the new docs.

### Why

The current "Native Module" docs may or may not be relevant with the new template - this PR is to move the focus off of those docs (without deleting them just yet) and have clean updated docs that describe how to use the new template.

Resolves #982
Resolves #999 

## Screenshots
N/A

### Why

The current "Native Module" docs may or may not be relevant with the new
template - this PR is to move the focus off of those docs (without
deleting them just yet) and have clean updated docs that describe how to
use the new template.

Resolves #982
Resolves #999 

## Screenshots
N/A

---------

Co-authored-by: Tatiana Kapos <tatianakapos@microsoft.com>

Author: jonthysell

.spelling

@@ -46,7 +46,9 @@ initializer
 interop
 iOS
 ItemGroup
+JSValue
 KeyEvents
+Kotlin
 lifecycle
 macOS
 middleware
@@ -80,6 +82,7 @@ Quickstart
 react-native
 react-native-macos
 react-native-windows
+reactnative.dev
 RefreshControl
 repo
 repos
@@ -96,6 +99,7 @@ struct
 symlink
 symlinks
 tada
+testlib
 TextInput
 theming
 toolchain

docs/autolink-windows-cli.md

@@ -31,7 +31,9 @@ Here are the options that `react-native autolink-windows` takes:
 | `--no-telemetry`      | boolean    | Disables sending telemetry that allows analysis of usage and failures of the react-native-windows CLI |
 | `-h`, `--help`        | boolean    | Display help for command                         |
 
-This sends telemetry to Microsoft by default. You can prevent the telemetry from being sent by using the `--no-telemetry` command line option. See below for more details.
+## Telemetry Notice
+
+This command sends telemetry to Microsoft by default. You can prevent the telemetry from being sent by using the `--no-telemetry` command line option. See below for more details.
 
 The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
 

docs/codegen-windows-cli.md

@@ -27,7 +27,51 @@ Here are the options that `react-native codegen-windows` takes:
 | `--no-telemetry`      | boolean    | Disables sending telemetry that allows analysis of usage and failures of the react-native-windows CLI |
 | `-h`, `--help`        | boolean    | Display help for command                         |
 
-This sends telemetry to Microsoft by default. You can prevent the telemetry from being sent by using the `--no-telemetry` command line option. See below for more details.
+## Codegen Config
+
+The `react-native codegen-windows` command is configured by the `codegenConfig` object in the project's `package.json` file. This `codegenConfig` object is shared by all platforms, but the relevant parts for React Native for Windows is configured as follows:
+
+| Field | Type| Description |
+|:------|:---:|:------------|
+| `type` | string | `"modules"` for Native Modules, `"components"` for Native Components, or `"all"` for both |
+| `jsSrcDir` | string | Path to the TypeScript spec input files |
+| `windows` | object | Windows-specific codegen configuration |
+
+The `windows` object is configured as follows:
+
+| Field | Type| Description |
+|:------|:---:|:------------|
+| `namespace` | string | The C++ namespace to contain the generated code |
+| `cppStringType` | string | Optional, the string type to use in C++ code, either `"std::string"` or `std::wstring`. Defaults to `"std::string"` |
+| `generators` | array | Optional, array of codegen generator strings, accepting `"modulesWindows"` for Native Modules, `"componentsWindows"` for Native Components. Defaults to `[ "modulesWindows" ]` |
+| `outputDirectory` | string | Optional, path to place the generated code. Defaults to `./codegen/` of the working directory |
+| `separateDataTypes` | boolean | Optional, specify whether to create separate files to define custom data types. Defaults to `false` |
+
+> **Note:** For more information on how to configure the `codegenConfig` object for other platforms, see the [reactnative.dev Configuring Codegen](https://reactnative.dev/docs/the-new-architecture/using-codegen#configuring-codegen) page.
+
+### Example Codegen Config
+
+```json
+"codegenConfig": {
+    "name": "NativeModuleSampleSpec",
+    "type": "all",
+    "jsSrcsDir": "src",
+    "includesGeneratedCode": true,
+    "windows": {
+      "namespace": "NativeModuleSampleCodegen",
+      "generators": [
+        "modulesWindows",
+        "componentsWindows"
+      ],
+      "outputDirectory": "windows/NativeModuleSample/codegen",
+      "separateDataTypes": true
+    }
+  },
+```
+
+## Telemetry Notice
+
+This command sends telemetry to Microsoft by default. You can prevent the telemetry from being sent by using the `--no-telemetry` command line option. See below for more details.
 
 The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
 

docs/getting-started.md

@@ -15,13 +15,12 @@ For information around how to set up React Native, see the [React Native Getting
 
 ## Create a new React Native project
 
-Remember to call `@react-native-community/cli init` from the place you want your project directory to live.
+Call the following from the place where you want your project directory to live:
 
 <!-- Note, make sure both `@react-native-community/cli@ABC` and `--version "XYZ"` are pointing to the correct NPM tags in the command below. -->
 
 <!-- 1. For the next version (i.e. in docs/getting-started.md) use "next" for the CLI and "nightly" for the RN version -->
-<!-- 2. For the latest stable version in versioned_docs use "latest" for both the CLI and RN version -->
-<!-- 3. For older stable versions you'll have to look up the CLI version, but for the RN version use the stable tag name, i.e. "0.73-stable" -->
+<!-- 2. For stable versions in versioned_docs use "latest" for the CLI and the semantic version, i.e. "^0.73.0" for the RN version -->
 
 <!-- See https://www.npmjs.com/package/@react-native-community/cli?activeTab=versions for the CLI version tags. -->
 <!-- See https://www.npmjs.com/package/react-native?activeTab=versions for the RN version tags. -->
@@ -32,7 +31,7 @@ npx --yes @react-native-community/cli@next init <projectName> --version "nightly
 
 ### Navigate into this newly created directory
 
-React Native will have created your project in a new sub-directory, which you must enter before continuing.
+The command will create your project in a new sub-directory, which you must enter before continuing:
 
 ```bat
 cd <projectName>
@@ -45,6 +44,8 @@ cd <projectName>
 <!-- 1. For the next version (i.e. in docs/getting-started.md) use "canary" -->
 <!-- 2. For other versions in versioned_docs use the version in the format "^0.XY.0" -->
 
+Next you'll want to add `react-native-windows` as a dependency:
+
 <!--DOCUSAURUS_CODE_TABS-->
 
 <!--Using Yarn (Recommended)-->
@@ -119,7 +120,7 @@ npx react-native init-windows --overwrite
 
 ## Authoring Native Modules
 
-See [Native Modules and React Native Windows](native-modules.md).
+See [Native Platform: Overview](native-platform.md).
 
 ## Building a standalone React Native Windows App
 

docs/init-windows-cli.md

@@ -30,20 +30,20 @@ Here are the options that `react-native init-windows` takes:
 | `--no-telemetry`      | boolean    | Disables sending telemetry that allows analysis of usage and failures of the react-native-windows CLI |
 | `-h`, `--help`        | boolean    | Display help for command                         |
 
-### Templates
+## Templates
 
 The following templates are available for use with `init-windows` by replacing `--template XYZ`, where `XYZ` can be:
 
 | Template | Name |
 |:-:|:--|
-| `cpp-app` | React Native Windows Application (New Arch, C++, Win32, Hermes) |
-| `cpp-lib` | React Native Windows Turbo Module (New Arch, C++) |
+| `cpp-app` | React Native Windows Application (New Arch, WinAppSDK, C++) |
+| `cpp-lib` | React Native Windows Library (C++) |
 | `old/uwp-cpp-app` | React Native Windows Application (Old Arch, UWP, C++) |
-| `old/uwp-cpp-lib` | React Native Windows Library (Old Arch, UWP, C++) |
 | `old/uwp-cs-app` | React Native Windows Application (Old Arch, UWP, C#)  |
-| `old/uwp-cs-lib` | React Native Windows Library (Old Arch, UWP, C#)  |
 
-This sends telemetry to Microsoft by default. You can prevent the telemetry from being sent by using the `--no-telemetry` command line option. See below for more details.
+## Telemetry Notice
+
+This command sends telemetry to Microsoft by default. You can prevent the telemetry from being sent by using the `--no-telemetry` command line option. See below for more details.
 
 The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.
 

docs/native-code-language-choice.md

@@ -7,9 +7,11 @@ title: Choosing C++ or C# for native code
 
 > **Architecture Review Needed:** This documentation was written to support development against React Native's "Old" or "Legacy" Architecture. It *may or may not* be directly applicable to New Architecture development and needs to be reviewed and potentially updated. For information on React Native architectures in React Native Windows, see [New vs. Old Architecture](new-architecture.md).
 
+> For the latest information on native development on Windows, see [Native Platform: Overview](native-platform.md).
+
 React Native for Windows supports writing native code in both C++ and C#, but there are trade-offs with each language. The choice of language can impact the compatibility, developer experience, and performance of your project. So whether you're building an app or native module, you should choose the native language that best meets your requirements.
 
-> **Note**: In this document, C++ refers specifically to C++/WinRT.
+> **Note:** In this document, C++ refers specifically to C++/WinRT.
 
 ## Common Considerations
 

docs/native-code.md

@@ -7,6 +7,8 @@ title: Working with native code on Windows
 
 > **Architecture Review Needed:** This documentation was written to support development against React Native's "Old" or "Legacy" Architecture. It *may or may not* be directly applicable to New Architecture development and needs to be reviewed and potentially updated. For information on React Native architectures in React Native Windows, see [New vs. Old Architecture](new-architecture.md).
 
+> For the latest information on native development on Windows, see [Native Platform: Overview](native-platform.md).
+
 ## What is a React Native for Windows app?
 
 When you create a React Native for Windows app targeting React Native's old architecture, you will get a [Universal Windows Platform app](https://docs.microsoft.com/windows/uwp/get-started/universal-application-platform-guide) (aka UWP app).

docs/native-modules-advanced.md

@@ -7,6 +7,8 @@ title: Native Modules (Advanced)
 
 > **Architecture Review Needed:** This documentation was written to support development against React Native's "Old" or "Legacy" Architecture. It *may or may not* be directly applicable to New Architecture development and needs to be reviewed and potentially updated. For information on React Native architectures in React Native Windows, see [New vs. Old Architecture](new-architecture.md).
 
+> For the latest information on native development on Windows, see [Native Platform: Overview](native-platform.md).
+
 >**This documentation and the underlying platform code is a work in progress.**
 >**Examples (C# and C++/WinRT):**
 > - [Native Module Sample in `microsoft/react-native-windows-samples`](https://github.com/microsoft/react-native-windows-samples/tree/main/samples-old/NativeModuleSample)

docs/native-modules-async.md

@@ -7,6 +7,8 @@ title: Using Asynchronous Windows APIs
 
 > **Architecture Review Needed:** This documentation was written to support development against React Native's "Old" or "Legacy" Architecture. It *may or may not* be directly applicable to New Architecture development and needs to be reviewed and potentially updated. For information on React Native architectures in React Native Windows, see [New vs. Old Architecture](new-architecture.md).
 
+> For the latest information on native development on Windows, see [Native Platform: Overview](native-platform.md).
+
 >**This documentation and the underlying platform code is a work in progress.**
 
 A common scenario for [Native Modules](native-modules.md) is to call one or more native asynchronous methods from a JS asynchronous method. However it may not be immediately obvious how to properly bridge both asynchronous worlds, which can lead to unstable, difficult to debug code.

docs/native-modules-autolinking.md

@@ -7,6 +7,8 @@ title: Autolinking Native Modules
 
 > **Architecture Review Needed:** This documentation was written to support development against React Native's "Old" or "Legacy" Architecture. It *may or may not* be directly applicable to New Architecture development and needs to be reviewed and potentially updated. For information on React Native architectures in React Native Windows, see [New vs. Old Architecture](new-architecture.md).
 
+> For the latest information on native development on Windows, see [Native Platform: Overview](native-platform.md).
+
 Autolinking is a mechanism that allows your React Native app project to discover and use native modules and view managers provided by React Native libraries.
 
 This document covers autolinking for the Windows platform. It is an extension to the [React Native CLI Autolinking doc](https://github.com/react-native-community/cli/blob/master/docs/autolinking.md).