refactor: deprecate old INCOMPATIBLE_* message names (#4703)

* refactor: deprecate old `INCOMPATIBLE_*` message names

* docs: fix link

Author: paul-soporan

.yarn/versions/8d0d4b16.yml

@@ -0,0 +1,34 @@
+releases:
+  "@yarnpkg/core": patch
+
+declined:
+  - "@yarnpkg/plugin-compat"
+  - "@yarnpkg/plugin-constraints"
+  - "@yarnpkg/plugin-dlx"
+  - "@yarnpkg/plugin-essentials"
+  - "@yarnpkg/plugin-exec"
+  - "@yarnpkg/plugin-file"
+  - "@yarnpkg/plugin-git"
+  - "@yarnpkg/plugin-github"
+  - "@yarnpkg/plugin-http"
+  - "@yarnpkg/plugin-init"
+  - "@yarnpkg/plugin-interactive-tools"
+  - "@yarnpkg/plugin-link"
+  - "@yarnpkg/plugin-nm"
+  - "@yarnpkg/plugin-npm"
+  - "@yarnpkg/plugin-npm-cli"
+  - "@yarnpkg/plugin-pack"
+  - "@yarnpkg/plugin-patch"
+  - "@yarnpkg/plugin-pnp"
+  - "@yarnpkg/plugin-pnpm"
+  - "@yarnpkg/plugin-stage"
+  - "@yarnpkg/plugin-typescript"
+  - "@yarnpkg/plugin-version"
+  - "@yarnpkg/plugin-workspace-tools"
+  - "@yarnpkg/builder"
+  - "@yarnpkg/cli"
+  - "@yarnpkg/doctor"
+  - "@yarnpkg/extensions"
+  - "@yarnpkg/nm"
+  - "@yarnpkg/pnpify"
+  - "@yarnpkg/sdks"

packages/gatsby/content/advanced/error-codes.md

@@ -314,11 +314,11 @@ A package is marked as deprecated by the publisher. Avoid using it, use the alte
 
 ## YN0062 - `INCOMPATIBLE_OS`
 
-A package is incompatible with the operating system, as reported by [`process.platform`](https://nodejs.org/api/process.html#process_process_platform).  Its installation will be skipped.
+> **Removed:** Replaced by [`INCOMPATIBLE_ARCHITECTURE`](#yn0076---incompatible_architecture).
 
 ## YN0063 - `INCOMPATIBLE_CPU`
 
-A package is incompatible with the CPU architecture, as reported by [`process.arch`](https://nodejs.org/api/process.html#process_process_arch).  Its installation will be skipped.
+> **Removed:** Replaced by [`INCOMPATIBLE_ARCHITECTURE`](#yn0076---incompatible_architecture).
 
 ## YN0068 - `UNUSED_PACKAGE_EXTENSION`
 
@@ -361,7 +361,7 @@ For more information about the parameters that must be instantiated when calling
 
 ## YN0076 - `INCOMPATIBLE_ARCHITECTURE`
 
-A package is specified in its manifest (through the [`os`](/configuration/manifest#os) / [`cpu`](/configuration/manifest#cpu) fields) as being incompatible with the system architecture. Its postinstall scripts will not run on this system.
+A package is specified in its manifest (through the [`os`](/configuration/manifest#os) / [`cpu`](/configuration/manifest#cpu) / [`libc`](/configuration/manifest#libc) fields) as being incompatible with the system architecture. It will not be fetched, linked, and its postinstall scripts will not run on this system.
 
 ## YN0077 - `GHOST_ARCHITECTURE`
 

packages/yarnpkg-core/sources/MessageName.ts

@@ -64,7 +64,13 @@ export enum MessageName {
   INVALID_RANGE_PEER_DEPENDENCY = 59,
   INCOMPATIBLE_PEER_DEPENDENCY = 60,
   DEPRECATED_PACKAGE = 61,
+  /**
+   * @deprecated Use {@link INCOMPATIBLE_ARCHITECTURE}
+   */
   INCOMPATIBLE_OS = 62,
+  /**
+   * @deprecated Use {@link INCOMPATIBLE_ARCHITECTURE}
+   */
   INCOMPATIBLE_CPU = 63,
   FROZEN_ARTIFACT_EXCEPTION = 64,
   TELEMETRY_NOTICE = 65,