From b563993413f36f3289a864ab06b13f7561f7f5ad Mon Sep 17 00:00:00 2001
From: Dave Bakker <github@davebakker.io>
Date: Wed, 7 Aug 2024 09:30:35 +0200
Subject: [PATCH] Remove documentation on the numeric resource id value.

---
 imports.md    | 5 -----
 wit/types.wit | 6 ------
 2 files changed, 11 deletions(-)

diff --git a/imports.md b/imports.md
index cede769..ba18125 100644
--- a/imports.md
+++ b/imports.md
@@ -1170,11 +1170,6 @@ WASI.</p>
 </ul>
 <h4><a name="method_descriptor_open_at"></a><code>[method]descriptor.open-at: func</code></h4>
 <p>Open a file or directory.</p>
-<p>The returned descriptor is not guaranteed to be the lowest-numbered
-descriptor not currently open/ it is randomized to prevent applications
-from depending on making assumptions about indexes, since this is
-error-prone in multi-threaded contexts. The returned descriptor is
-guaranteed to be less than 2**31.</p>
 <p>If <code>flags</code> contains <a href="#descriptor_flags.mutate_directory"><code>descriptor-flags::mutate-directory</code></a>, and the base
 descriptor doesn't have <a href="#descriptor_flags.mutate_directory"><code>descriptor-flags::mutate-directory</code></a> set,
 <code>open-at</code> fails with <a href="#error_code.read_only"><code>error-code::read-only</code></a>.</p>
diff --git a/wit/types.wit b/wit/types.wit
index db3d968..db3f3c6 100644
--- a/wit/types.wit
+++ b/wit/types.wit
@@ -523,12 +523,6 @@ interface types {
 
         /// Open a file or directory.
         ///
-        /// The returned descriptor is not guaranteed to be the lowest-numbered
-        /// descriptor not currently open/ it is randomized to prevent applications
-        /// from depending on making assumptions about indexes, since this is
-        /// error-prone in multi-threaded contexts. The returned descriptor is
-        /// guaranteed to be less than 2**31.
-        ///
         /// If `flags` contains `descriptor-flags::mutate-directory`, and the base
         /// descriptor doesn't have `descriptor-flags::mutate-directory` set,
         /// `open-at` fails with `error-code::read-only`.