docs(http): improve unstable API notices (#5483)

denoland · Jul 19, 2024 · 0cf0431 · 0cf0431
1 parent 2759686
commit 0cf0431
Showing 1 changed file with 9 additions and 6 deletions.
diff --git a/http/signed_cookie.ts b/http/signed_cookie.ts
@@ -12,11 +12,12 @@ function splitByLast(value: string, separator: string): [string, string] {
 }
 
 /**
- * **UNSTABLE**: New API, yet to be vetted.
- *
  * Returns a promise with the signed cookie value from the given cryptographic
  * key.
  *
+ * > [!WARNING]
+ * > **UNSTABLE**: New API, yet to be vetted.
+ *
  * @experimental
  *
  * @example Usage
@@ -55,10 +56,11 @@ export async function signCookie(
 }
 
 /**
- * **UNSTABLE**: New API, yet to be vetted.
- *
  * Returns a promise of a boolean indicating whether the signed cookie is valid.
  *
+ * > [!WARNING]
+ * > **UNSTABLE**: New API, yet to be vetted.
+ *
  * @experimental
  *
  * @example Usage
@@ -98,10 +100,11 @@ export async function verifySignedCookie(
 }
 
 /**
- * **UNSTABLE**: New API, yet to be vetted.
- *
  * Parses a signed cookie to get its value.
  *
+ * > [!WARNING]
+ * > **UNSTABLE**: New API, yet to be vetted.
+ *
  * Important: always verify the cookie using {@linkcode verifySignedCookie} first.
  *
  * @experimental