From c6921091630208f9eabb16ad4c8bf66fd5774f45 Mon Sep 17 00:00:00 2001
From: Aviv Keller <redyetidev@gmail.com>
Date: Tue, 1 Oct 2024 12:57:28 -0400
Subject: [PATCH] doc: put errors in right location

---
 doc/api/errors.md | 136 +++++++++++++++++++++++-----------------------
 1 file changed, 67 insertions(+), 69 deletions(-)

diff --git a/doc/api/errors.md b/doc/api/errors.md
index a6aaa57d924f26..c4ba0966522edd 100644
--- a/doc/api/errors.md
+++ b/doc/api/errors.md
@@ -2344,6 +2344,17 @@ A non-context-aware native addon was loaded in a process that disallows them.
 
 A given value is out of the accepted range.
 
+<a id="ERR_OPERATION_FAILED"></a>
+
+### `ERR_OPERATION_FAILED`
+
+<!-- YAML
+added: v15.0.0
+-->
+
+An operation failed. This is typically used to signal the general failure
+of an asynchronous operation.
+
 <a id="ERR_PACKAGE_IMPORT_NOT_DEFINED"></a>
 
 ### `ERR_PACKAGE_IMPORT_NOT_DEFINED`
@@ -2420,6 +2431,42 @@ Accessing `Object.prototype.__proto__` has been forbidden using
 [`Object.setPrototypeOf`][] should be used to get and set the prototype of an
 object.
 
+<a id="ERR_QUIC_CONNECTION_FAILED"></a>
+
+### `ERR_QUIC_CONNECTION_FAILED`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+> Stability: 1 - Experimental
+
+Establishing a QUIC connection failed.
+
+<a id="ERR_QUIC_ENDPOINT_CLOSED"></a>
+
+### `ERR_QUIC_ENDPOINT_CLOSED`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+> Stability: 1 - Experimental
+
+A QUIC Endpoint closed with an error.
+
+<a id="ERR_QUIC_OPEN_STREAM_FAILED"></a>
+
+### `ERR_QUIC_OPEN_STREAM_FAILED`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+> Stability: 1 - Experimental
+
+Opening a QUIC stream failed.
+
 <a id="ERR_REQUIRE_CYCLE_MODULE"></a>
 
 ### `ERR_REQUIRE_CYCLE_MODULE`
@@ -2448,25 +2495,6 @@ To see where the top-level await is, use
 `--experimental-print-required-tla` (this would execute the modules
 before looking for the top-level awaits).
 
-<a id="ERR_REQUIRE_ESM"></a>
-
-### `ERR_REQUIRE_ESM`
-
-<!-- YAML
-changes:
-  - version: REPLACEME
-    pr-url: https://github.com/nodejs/node/pull/55085
-    description: require() now supports loading synchronous ES modules by default.
--->
-
-> Stability: 0 - Deprecated
-
-An attempt was made to `require()` an [ES Module][].
-
-This error has been deprecated since `require()` now supports loading synchronous
-ES modules. When `require()` encounters an ES module that contains top-level
-`await`, it will throw [`ERR_REQUIRE_ASYNC_MODULE`][] instead.
-
 <a id="ERR_SCRIPT_EXECUTION_INTERRUPTED"></a>
 
 ### `ERR_SCRIPT_EXECUTION_INTERRUPTED`
@@ -3271,6 +3299,16 @@ removed: v12.5.0
 The value passed to `postMessage()` contained an object that is not supported
 for transferring.
 
+<a id="ERR_CPU_USAGE"></a>
+
+### `ERR_CPU_USAGE`
+
+<!-- YAML
+removed: v15.0.0
+-->
+
+The native call from `process.cpuUsage` could not be processed.
+
 <a id="ERR_CRYPTO_HASH_DIGEST_NO_UTF16"></a>
 
 ### `ERR_CRYPTO_HASH_DIGEST_NO_UTF16`
@@ -3610,17 +3648,6 @@ Used by the `Node-API` when `Constructor.prototype` is not an object.
 A Node.js API was called in an unsupported manner, such as
 `Buffer.write(string, encoding, offset[, length])`.
 
-<a id="ERR_OPERATION_FAILED"></a>
-
-### `ERR_OPERATION_FAILED`
-
-<!-- YAML
-added: v15.0.0
--->
-
-An operation failed. This is typically used to signal the general failure
-of an asynchronous operation.
-
 <a id="ERR_OUTOFMEMORY"></a>
 
 ### `ERR_OUTOFMEMORY`
@@ -3644,41 +3671,22 @@ removed: v10.0.0
 
 The `node:repl` module was unable to parse data from the REPL history file.
 
-<a id="ERR_QUIC_CONNECTION_FAILED"></a>
-
-### `ERR_QUIC_CONNECTION_FAILED`
-
-<!-- YAML
-added: REPLACEME
--->
-
-> Stability: 1 - Experimental
-
-Establishing a QUIC connection failed.
-
-<a id="ERR_QUIC_ENDPOINT_CLOSED"></a>
-
-### `ERR_QUIC_ENDPOINT_CLOSED`
-
-<!-- YAML
-added: REPLACEME
--->
-
-> Stability: 1 - Experimental
-
-A QUIC Endpoint closed with an error.
-
-<a id="ERR_QUIC_OPEN_STREAM_FAILED"></a>
+<a id="ERR_REQUIRE_ESM"></a>
 
-### `ERR_QUIC_OPEN_STREAM_FAILED`
+### `ERR_REQUIRE_ESM`
 
 <!-- YAML
-added: REPLACEME
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/55085
+    description: require() now supports loading synchronous ES modules by default.
 -->
 
-> Stability: 1 - Experimental
+An attempt was made to `require()` an [ES Module][].
 
-Opening a QUIC stream failed.
+This error has been deprecated since `require()` now supports loading synchronous
+ES modules. When `require()` encounters an ES module that contains top-level
+`await`, it will throw [`ERR_REQUIRE_ASYNC_MODULE`][] instead.
 
 <a id="ERR_SOCKET_CANNOT_SEND"></a>
 
@@ -3850,16 +3858,6 @@ removed: v10.0.0
 Used when an attempt is made to use a `zlib` object after it has already been
 closed.
 
-<a id="ERR_CPU_USAGE"></a>
-
-### `ERR_CPU_USAGE`
-
-<!-- YAML
-removed: v15.0.0
--->
-
-The native call from `process.cpuUsage` could not be processed.
-
 <a id="openssl-error-codes"></a>
 
 ## OpenSSL Error Codes