Merge branch 'master' of https://github.com/SharePoint/sp-dev-docs

Author: VesaJuvonen

docs/spfx/release-1.12.1.md

@@ -1,7 +1,7 @@
 ---
 title: SharePoint Framework v1.12.1 release notes
 description: Release notes for the SharePoint Framework v1.12.1 release
-ms.date: 09/08/2021
+ms.date: 12/28/2021
 ms.prod: sharepoint
 ms.localizationpriority: high
 ---
@@ -43,10 +43,11 @@ This release introduces a new property & event in the Web Part API to detect the
 
 - Add support for **Node.js v12.13.x & v14.15.x**
   - *See [Set up your SharePoint Framework development environment](set-up-your-development-environment.md) for details.*
-  - **Gulp v4** (installed globally) is required (*see [Regarding Gulp versions & Node.js v12+](#gulp-versions--nodejs-v12) for details*)
+  - **Gulp-CLI** is strongly recommended. Our prior guidance was to install Gulp v3 or v4 globally, but the guidance from the Gulp team is to only install Gulp CLI globally. By using the Gulp CLI, you can have projects that use Gulp v3 and others that use Gulp v4.
 - For all projects:
   - Update the default version of TypeScript to **v3.7** (*via **@microsoft/rush-stack-compiler-3.7** v0.2.3*)
-  - Update the **Gulp** version used to **v4.0.2**
+  - Update **Gulp** version used to **v4.0.2**
+      > *see [Regarding Gulp versions & Node.js v12+](#gulp-versions--nodejs-v12) for details*
 - For projects that use React:
   - Update the React NPM packages (**react** & **react-dom**) to **v16.9.0**.
   - Update the Office UI Fabric React NPM package / Microsoft Fluent UI (**office-ui-fabric-react**) to **v7.156.0**.

docs/spfx/sharepoint-2016-support.md

@@ -1,7 +1,7 @@
 ---
 title: SharePoint Framework development with SharePoint 2016 Feature Pack 2
 description: SharePoint Server 2016 Feature Pack 2 supports SharePoint Framework client-side web parts hosted in classic SharePoint pages.
-ms.date: 06/22/2021
+ms.date: 12/28/2021
 ms.localizationpriority: high
 ---
 # SharePoint Framework development with SharePoint Server 2016 Feature Pack 2
@@ -54,12 +54,24 @@ The dependencies for SPFx v1.1 frameworks, tools, and the associated versions do
 
 For example, Gulp v3.* is only supported up to Node.js v10, while Gulp v4.* is supported from Node.js v12 and higher. Because SPFx v1.1 is only supported on Node.js v6 and Node.js v8, you need to ensure you have an older version of Node.js installed as well as an older version of Gulp & Yeoman.
 
-If you're building SPFx v1.1 solutions, install the following specific versions of Gulp & Yeoman:
+> [!NOTE]
+> The Gulp team introduced a separate package, [gulp-cli](https://www.npmjs.com/package/gulp-cli), that should be installed globally. It can be used by projects that use either Gulp v3 & Gulp v4.
+>
+> Learn more about the gulp-cli here: [gulpjs/gulp/#2324](https://github.com/gulpjs/gulp/issues/2324).
 
-```console
-npm install --global [email protected]
-npm install --global [email protected]
-```
+Microsoft recommends using the most recent version of the Yeoman generator for the SharePoint Framework ([@microsoft/generator-sharepoint](https://www.npmjs.com/package/@microsoft/generator-sharepoint)) that supports creating on-premises projects: SPFx v1.6.0.
+
+> [!IMPORTANT]
+> The Yeoman generator for the SharePoint Framework, starting with v1.13.0, only supports projects for SharePoint Online. Learn more about this change in the [SharePoint Framework v1.13 release notes](release-1.13.md). However, SPFx 1.1.1 only supports up to Node.js v6. Therefore, you need to get the latest version of the Yeoman generator for the SharePoint Framework (v1.6.0) that works on the same version of Node.js (v6) that SPFx v1.1.0 is supported on.
+
+1. Install [Node.js v6.17.1](https://nodejs.org/download/release/v6.17.1/)
+1. Install global dependencies
+
+    ```console
+    npm install [email protected] --global
+    npm install [email protected] --global
+    npm install @microsoft/[email protected] --global
+    ```
 
 For more information, see [SharePoint Framework development tools and libraries compatibility](compatibility.md).
 

docs/spfx/sharepoint-2019-support.md

@@ -1,13 +1,16 @@
 ---
-title: SharePoint Framework development with SharePoint 2019
+title: SharePoint Framework development with SharePoint Server 2019 & SharePoint Server SE
 description: SharePoint Server 2019 supports SharePoint Framework client-side web parts in classic and modern pages, and extensions in modern pages.
-ms.date: 06/22/2021
+ms.date: 12/28/2021
 ms.localizationpriority: high
 ---
-# SharePoint Framework development with SharePoint Server 2019
+# SharePoint Framework development with SharePoint Server 2019 & SharePoint Server SE
 
 SharePoint Server 2019 supports SharePoint Framework client-side web parts in classic and pages, and extensions in modern pages.
 
+> [!IMPORTANT]
+> SharePoint Server Subscription Edition (SE) has all the same dependencies and requirements for the SharePoint Framework as SharePoint Server 2019.
+
 ## Which version of the SharePoint Framework to use
 
 Because SharePoint Online and SharePoint Server 2019 have different release cycles for new capabilities, they also have different capabilities when it comes to the SharePoint Framework. SharePoint Online always uses the latest version of the SharePoint Framework, but SharePoint Server 2019 only supports the version that matches the server-side dependencies of the deployed packages.
@@ -24,18 +27,30 @@ If Internet access isn't available for the development machines, you can set up
 
 The [Team-based development on the SharePoint Framework](team-based-development-on-sharepoint-framework.md) guidance document includes different options for development environment setup including when you might need to support multiple SharePoint Framework versions.
 
-### Node.js, Gulp & Yeoman versions
+### Node.js, Gulp, & Yeoman versions
 
 The dependencies for SPFx v1.4.1 frameworks, tools, and the associated versions don't match the same dependency matrix for the latest versions of SPFx. In these cases, you may need to install specific versions of the tools.
 
 For example, Gulp v3.* is only supported up to Node.js v10, while Gulp v4.* is supported from Node.js v12 and higher. Because SPFx v1.4.1 is only supported on Node.js v6 and Node.js v8, you need to ensure you have an older version of Node.js installed as well as an older version of Gulp & Yeoman.
 
-If you're building SPFx v1.1 solutions, install the following specific versions of Gulp & Yeoman:
+> [!NOTE]
+> The Gulp team introduced a separate package, [gulp-cli](https://www.npmjs.com/package/gulp-cli), that should be installed globally. It can be used by projects that use either Gulp v3 & Gulp v4.
+>
+> Learn more about the gulp-cli here: [gulpjs/gulp/#2324](https://github.com/gulpjs/gulp/issues/2324).
+
+Microsoft recommends using the most recent version of the Yeoman generator for the SharePoint Framework ([@microsoft/generator-sharepoint](https://www.npmjs.com/package/@microsoft/generator-sharepoint)) that supports creating on-premises projects: SPFx v1.10.1.
+
+> [!IMPORTANT]
+> The Yeoman generator for the SharePoint Framework, starting with v1.13.0, only supports projects for SharePoint Online. Learn more about this change in the [SharePoint Framework v1.13 release notes](release-1.13.md). However, SPFx 1.4.1 only supports up to Node.js v10. Therefore, you need to get the latest version of the Yeoman generator for the SharePoint Framework (v1.10.0) that works on the same version of Node.js (v10) that SPFx v1.4.1 is supported on.
+
+1. Install [Node.js v10.24.1](https://nodejs.org/download/release/v10.24.1/)
+1. Install global dependencies
 
-```console
-npm install --global [email protected]
-npm install --global [email protected]
-```
+    ```console
+    npm install [email protected] --global
+    npm install [email protected] --global
+    npm install @microsoft/[email protected] --global
+    ```
 
 For more information, see [SharePoint Framework development tools and libraries compatibility](compatibility.md).
 

docs/toc.yml

@@ -442,7 +442,7 @@
       href: spfx/supported-extensibility-platforms-overview.md
     - name: SharePoint Online
       href: spfx/spfx-sharepoint-online.md
-    - name: SharePoint 2019 support
+    - name: SharePoint 2019 & SE support
       href: spfx/sharepoint-2019-support.md
     - name: SharePoint 2016 support
       href: spfx/sharepoint-2016-support.md