From 5c9854720133910e4372e1c84c09bb9ca8c0bb91 Mon Sep 17 00:00:00 2001
From: babiabeo <ducthangn71007@gmail.com>
Date: Thu, 25 Jan 2024 18:06:06 +0700
Subject: [PATCH 1/3] docs: use `@link` tags instead of hyperlinks

---
 collections/mod.ts        |  8 +++++---
 crypto/crypto.ts          |  2 +-
 encoding/ascii85.ts       | 10 +++++-----
 encoding/base32.ts        |  6 +++---
 encoding/base58.ts        |  6 +++---
 encoding/base64.ts        |  6 +++---
 encoding/base64url.ts     |  5 +++--
 encoding/hex.ts           |  6 +++---
 io/buf_reader.ts          | 10 +++++-----
 io/buf_writer.ts          |  4 ++--
 io/copy_n.ts              |  2 +-
 io/limited_reader.ts      |  2 +-
 io/multi_reader.ts        |  2 +-
 io/read_delim.ts          |  2 +-
 io/read_int.ts            |  2 +-
 io/read_lines.ts          |  2 +-
 io/read_long.ts           |  2 +-
 io/read_range.ts          |  6 +++---
 io/read_short.ts          |  2 +-
 io/read_string_delim.ts   |  2 +-
 io/slice_long_to_bytes.ts |  2 +-
 io/string_reader.ts       |  2 +-
 io/string_writer.ts       |  2 +-
 permissions/mod.ts        | 10 +++++-----
 ulid/mod.ts               |  2 +-
 webgpu/mod.ts             |  2 +-
 26 files changed, 55 insertions(+), 52 deletions(-)

diff --git a/collections/mod.ts b/collections/mod.ts
index e7c9719ee311..93760b045bec 100644
--- a/collections/mod.ts
+++ b/collections/mod.ts
@@ -3,11 +3,13 @@
 
 /**
  * Pure functions for common tasks around collection types like arrays and
- * objects. Heavily inspired by
- * [Kotlin's `kotlin.collections`]{@linkcode https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/}
+ * objects.
+ *
+ * Heavily inspired by
+ * {@link https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/ | Kotlin's Collections}
  * package.
  *
- * @module.
+ * @module
  */
 
 export * from "./aggregate_groups.ts";
diff --git a/crypto/crypto.ts b/crypto/crypto.ts
index 3e3b2350f770..8131f94a783d 100644
--- a/crypto/crypto.ts
+++ b/crypto/crypto.ts
@@ -3,7 +3,7 @@
 
 /**
  * Extensions to the
- * [Web Crypto API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Web_Crypto_API}
+ * {@link https://developer.mozilla.org/en-US/docs/Web/API/Web_Crypto_API | Web Crypto API}
  * supporting additional encryption APIs, but also delegating to the built-in
  * APIs when possible.
  *
diff --git a/encoding/ascii85.ts b/encoding/ascii85.ts
index eea822ace169..1c186f96ac91 100644
--- a/encoding/ascii85.ts
+++ b/encoding/ascii85.ts
@@ -1,10 +1,8 @@
 // Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
 // This module is browser compatible.
 
-import { validateBinaryLike } from "./_util.ts";
-
 /**
- * Utilities for working with [ascii85]{@link https://en.wikipedia.org/wiki/Ascii85} encoding.
+ * Utilities for working with {@link https://en.wikipedia.org/wiki/Ascii85 | ascii85} encoding.
  *
  * This module is browser compatible.
  *
@@ -13,8 +11,8 @@ import { validateBinaryLike } from "./_util.ts";
  * By default, all functions are using the most popular Adobe version of ascii85
  * and not adding any delimiter. However, there are three more standards
  * supported - btoa (different delimiter and additional compression of 4 bytes
- * equal to 32), [Z85](https://rfc.zeromq.org/spec/32/) and
- * [RFC 1924](https://tools.ietf.org/html/rfc1924). It's possible to use a
+ * equal to 32), {@link https://rfc.zeromq.org/spec/32/ | Z85} and
+ * {@link https://tools.ietf.org/html/rfc1924 | RFC 1924}. It's possible to use a
  * different encoding by specifying it in `options` object as a second parameter.
  *
  * Similarly, it's possible to make `encode` add a delimiter (`<~` and `~>` for
@@ -25,6 +23,8 @@ import { validateBinaryLike } from "./_util.ts";
  * @module
  */
 
+import { validateBinaryLike } from "./_util.ts";
+
 /** Supported ascii85 standards for {@linkcode Ascii85Options}. */
 export type Ascii85Standard = "Adobe" | "btoa" | "RFC 1924" | "Z85";
 
diff --git a/encoding/base32.ts b/encoding/base32.ts
index db6001218042..acbe0089f3a6 100644
--- a/encoding/base32.ts
+++ b/encoding/base32.ts
@@ -2,11 +2,9 @@
 // Copyright (c) 2014 Jameson Little. MIT License.
 // This module is browser compatible.
 
-import { validateBinaryLike } from "./_util.ts";
-
 /**
  * Utilities for
- * [base32]{@link https://datatracker.ietf.org/doc/html/rfc4648#section-6}
+ * {@link https://datatracker.ietf.org/doc/html/rfc4648#section-6 | base32}
  * encoding and decoding.
  *
  * Modified from {@link https://github.com/beatgammit/base64-js}.
@@ -16,6 +14,8 @@ import { validateBinaryLike } from "./_util.ts";
  * @module
  */
 
+import { validateBinaryLike } from "./_util.ts";
+
 const lookup: string[] = [];
 const revLookup: number[] = [];
 
diff --git a/encoding/base58.ts b/encoding/base58.ts
index 1fb7f25d0046..b9886ae86944 100644
--- a/encoding/base58.ts
+++ b/encoding/base58.ts
@@ -1,11 +1,9 @@
 // Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
 // This module is browser compatible.
 
-import { validateBinaryLike } from "./_util.ts";
-
 /**
  * Utilities for
- * [base58]{@link https://datatracker.ietf.org/doc/html/draft-msporny-base58-03}
+ * {@link https://datatracker.ietf.org/doc/html/draft-msporny-base58-03 | base58}
  * encoding and decoding.
  *
  * This module is browser compatible.
@@ -13,6 +11,8 @@ import { validateBinaryLike } from "./_util.ts";
  * @module
  */
 
+import { validateBinaryLike } from "./_util.ts";
+
 // deno-fmt-ignore
 const mapBase58: Record<string, number> = {
   "1": 0, "2": 1, "3": 2, "4": 3, "5": 4, "6": 5, "7": 6, "8": 7, "9": 8, A: 9,
diff --git a/encoding/base64.ts b/encoding/base64.ts
index 9ea2ea329382..b229f136022d 100644
--- a/encoding/base64.ts
+++ b/encoding/base64.ts
@@ -1,11 +1,9 @@
 // Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
 // This module is browser compatible.
 
-import { validateBinaryLike } from "./_util.ts";
-
 /**
  * Utilities for
- * [base64]{@link https://datatracker.ietf.org/doc/html/rfc4648#section-4}
+ * {@link https://datatracker.ietf.org/doc/html/rfc4648#section-4 | base64}
  * encoding and decoding.
  *
  * This module is browser compatible.
@@ -13,6 +11,8 @@ import { validateBinaryLike } from "./_util.ts";
  * @module
  */
 
+import { validateBinaryLike } from "./_util.ts";
+
 const base64abc = [
   "A",
   "B",
diff --git a/encoding/base64url.ts b/encoding/base64url.ts
index 486f861bbe88..831718474f8d 100644
--- a/encoding/base64url.ts
+++ b/encoding/base64url.ts
@@ -3,7 +3,7 @@
 
 /**
  * Utilities for
- * [base64url]{@link https://datatracker.ietf.org/doc/html/rfc4648#section-5}
+ * {@link https://datatracker.ietf.org/doc/html/rfc4648#section-5 | base64url}
  * encoding and decoding.
  *
  * This module is browser compatible.
@@ -13,9 +13,10 @@
 
 import * as base64 from "./base64.ts";
 
-/*
+/**
  * Some variants allow or require omitting the padding '=' signs:
  * https://en.wikipedia.org/wiki/Base64#The_URL_applications
+ *
  * @param base64url
  */
 function addPaddingToBase64url(base64url: string): string {
diff --git a/encoding/hex.ts b/encoding/hex.ts
index 7270aed1a8f0..4f21681a27e0 100644
--- a/encoding/hex.ts
+++ b/encoding/hex.ts
@@ -3,11 +3,9 @@
 // Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
 // This module is browser compatible.
 
-import { validateBinaryLike } from "./_util.ts";
-
 /**
  * Port of the Go
- * [encoding/hex](https://github.com/golang/go/blob/go1.12.5/src/encoding/hex/hex.go)
+ * {@link https://github.com/golang/go/blob/go1.12.5/src/encoding/hex/hex.go | encoding/hex}
  * library.
  *
  * This module is browser compatible.
@@ -31,6 +29,8 @@ import { validateBinaryLike } from "./_util.ts";
  * @module
  */
 
+import { validateBinaryLike } from "./_util.ts";
+
 const hexTable = new TextEncoder().encode("0123456789abcdef");
 const textEncoder = new TextEncoder();
 const textDecoder = new TextDecoder();
diff --git a/io/buf_reader.ts b/io/buf_reader.ts
index 1121091456d6..6ff8569589d1 100644
--- a/io/buf_reader.ts
+++ b/io/buf_reader.ts
@@ -3,7 +3,7 @@
 
 /**
  * @module
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 
 import { assert } from "../assert/assert.ts";
@@ -17,7 +17,7 @@ const CR = "\r".charCodeAt(0);
 const LF = "\n".charCodeAt(0);
 
 /**
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export class BufferFullError extends Error {
   override name = "BufferFullError";
@@ -27,7 +27,7 @@ export class BufferFullError extends Error {
 }
 
 /**
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export class PartialReadError extends Error {
   override name = "PartialReadError";
@@ -40,7 +40,7 @@ export class PartialReadError extends Error {
 /**
  * Result type returned by of BufReader.readLine().
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export interface ReadLineResult {
   line: Uint8Array;
@@ -48,7 +48,7 @@ export interface ReadLineResult {
 }
 
 /**
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export class BufReader implements Reader {
   #buf!: Uint8Array;
diff --git a/io/buf_writer.ts b/io/buf_writer.ts
index e10f4ddda443..09def5144a0e 100644
--- a/io/buf_writer.ts
+++ b/io/buf_writer.ts
@@ -40,7 +40,7 @@ abstract class AbstractBufBase {
  * flush() method to guarantee all data has been forwarded to
  * the underlying deno.Writer.
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export class BufWriter extends AbstractBufBase implements Writer {
   #writer: Writer;
@@ -133,7 +133,7 @@ export class BufWriter extends AbstractBufBase implements Writer {
  * flush() method to guarantee all data has been forwarded to
  * the underlying deno.WriterSync.
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export class BufWriterSync extends AbstractBufBase implements WriterSync {
   #writer: WriterSync;
diff --git a/io/copy_n.ts b/io/copy_n.ts
index 28bf0de9323d..90ae468a804b 100644
--- a/io/copy_n.ts
+++ b/io/copy_n.ts
@@ -12,7 +12,7 @@ const DEFAULT_BUFFER_SIZE = 32 * 1024;
  * @param dest Writer
  * @param size Read size
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export async function copyN(
   r: Reader,
diff --git a/io/limited_reader.ts b/io/limited_reader.ts
index 84292111ed66..42b2c198f294 100644
--- a/io/limited_reader.ts
+++ b/io/limited_reader.ts
@@ -10,7 +10,7 @@
 import type { Reader } from "./types.ts";
 
 /**
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export class LimitedReader implements Reader {
   constructor(public reader: Reader, public limit: number) {}
diff --git a/io/multi_reader.ts b/io/multi_reader.ts
index 2fe5ec8eef0b..6d2f639a01b4 100644
--- a/io/multi_reader.ts
+++ b/io/multi_reader.ts
@@ -6,7 +6,7 @@ import type { Reader } from "./types.ts";
 /**
  * Reader utility for combining multiple readers
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export class MultiReader implements Reader {
   readonly #readers: Reader[];
diff --git a/io/read_delim.ts b/io/read_delim.ts
index a8b712080f95..7eff7d0e7ebc 100644
--- a/io/read_delim.ts
+++ b/io/read_delim.ts
@@ -28,7 +28,7 @@ function createLPS(pat: Uint8Array): Uint8Array {
 /**
  * Read delimited bytes from a Reader.
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export async function* readDelim(
   reader: Reader,
diff --git a/io/read_int.ts b/io/read_int.ts
index 46cdbcaf57cf..c0f55f013ea9 100644
--- a/io/read_int.ts
+++ b/io/read_int.ts
@@ -7,7 +7,7 @@ import { readShort } from "./read_short.ts";
  * Read big endian 32bit integer from BufReader
  * @param buf
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export async function readInt(buf: BufReader): Promise<number | null> {
   const high = await readShort(buf);
diff --git a/io/read_lines.ts b/io/read_lines.ts
index b1c1b0f7af0e..2a395fe347c3 100644
--- a/io/read_lines.ts
+++ b/io/read_lines.ts
@@ -21,7 +21,7 @@ import { concat } from "../bytes/concat.ts";
  * }
  * ```
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export async function* readLines(
   reader: Reader,
diff --git a/io/read_long.ts b/io/read_long.ts
index 64b0f05efa43..408f96ff4b52 100644
--- a/io/read_long.ts
+++ b/io/read_long.ts
@@ -9,7 +9,7 @@ const MAX_SAFE_INTEGER = BigInt(Number.MAX_SAFE_INTEGER);
  * Read big endian 64bit long from BufReader
  * @param buf
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export async function readLong(buf: BufReader): Promise<number | null> {
   const high = await readInt(buf);
diff --git a/io/read_range.ts b/io/read_range.ts
index 1feb0ddb0f28..824e83aafd10 100644
--- a/io/read_range.ts
+++ b/io/read_range.ts
@@ -7,7 +7,7 @@ import type { Reader, ReaderSync } from "./types.ts";
 const DEFAULT_BUFFER_SIZE = 32 * 1024;
 
 /**
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export interface ByteRange {
   /** The 0 based index of the start byte for a range. */
@@ -32,7 +32,7 @@ export interface ByteRange {
  * assertEquals(bytes.length, 10);
  * ```
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export async function readRange(
   r: Reader & Deno.Seeker,
@@ -72,7 +72,7 @@ export async function readRange(
  * assertEquals(bytes.length, 10);
  * ```
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export function readRangeSync(
   r: ReaderSync & Deno.SeekerSync,
diff --git a/io/read_short.ts b/io/read_short.ts
index e3725b75ffd4..4ba50eab4d6c 100644
--- a/io/read_short.ts
+++ b/io/read_short.ts
@@ -6,7 +6,7 @@ import { type BufReader } from "./buf_reader.ts";
  * Read big endian 16bit short from BufReader
  * @param buf
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export async function readShort(buf: BufReader): Promise<number | null> {
   const high = await buf.readByte();
diff --git a/io/read_string_delim.ts b/io/read_string_delim.ts
index 64d7cf7197e1..c7cbee184d25 100644
--- a/io/read_string_delim.ts
+++ b/io/read_string_delim.ts
@@ -20,7 +20,7 @@ import { readDelim } from "./read_delim.ts";
  * }
  * ```
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export async function* readStringDelim(
   reader: Reader,
diff --git a/io/slice_long_to_bytes.ts b/io/slice_long_to_bytes.ts
index ed1d1a91f47c..6e5752960e91 100644
--- a/io/slice_long_to_bytes.ts
+++ b/io/slice_long_to_bytes.ts
@@ -6,7 +6,7 @@
  * @param d The number to be sliced
  * @param dest The sliced array
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export function sliceLongToBytes(
   d: number,
diff --git a/io/string_reader.ts b/io/string_reader.ts
index 2180ca4165d9..b54ac9548adf 100644
--- a/io/string_reader.ts
+++ b/io/string_reader.ts
@@ -32,7 +32,7 @@ import { Buffer } from "./buffer.ts";
  * abcdef
  * ```
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export class StringReader extends Buffer {
   constructor(s: string) {
diff --git a/io/string_writer.ts b/io/string_writer.ts
index 61195e3f34e9..c3fa2347436c 100644
--- a/io/string_writer.ts
+++ b/io/string_writer.ts
@@ -35,7 +35,7 @@ const decoder = new TextDecoder();
  * base0123456789
  * ```
  *
- * @deprecated (will be removed after 1.0.0) Use the [Web Streams API]{@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API} instead.
+ * @deprecated (will be removed after 1.0.0) Use the {@link https://developer.mozilla.org/en-US/docs/Web/API/Streams_API | Web Streams API} instead.
  */
 export class StringWriter implements Writer, WriterSync {
   #chunks: Uint8Array[] = [];
diff --git a/permissions/mod.ts b/permissions/mod.ts
index ffbad42753cb..73271553511c 100644
--- a/permissions/mod.ts
+++ b/permissions/mod.ts
@@ -2,7 +2,7 @@
 /**
  * Helpers for interacting with Deno's permissions system.
  * @module
- * @deprecated (will be removed in 1.0.0) Use the [Deno Permissions API]{@link https://deno.land/api?s=Deno.Permissions} directly instead.
+ * @deprecated (will be removed in 1.0.0) Use the {@link https://deno.land/api?s=Deno.Permissions | Deno Permissions API} directly instead.
  */
 
 const { PermissionDenied } = Deno.errors;
@@ -47,7 +47,7 @@ function getPermissionString(descriptors: Deno.PermissionDescriptor[]): string {
  * If one of the permissions requires a prompt, the function will attempt to
  * prompt for it.  The function resolves with all of the granted permissions.
  *
- * @deprecated (will be removed in 1.0.0) Use the [Deno Permissions API]{@link https://deno.land/api?s=Deno.Permissions} directly instead.
+ * @deprecated (will be removed in 1.0.0) Use the {@link https://deno.land/api?s=Deno.Permissions | Deno Permissions API} directly instead.
  */
 export async function grant(
   ...descriptors: Deno.PermissionDescriptor[]
@@ -68,7 +68,7 @@ export async function grant(
  * If one of the permissions requires a prompt, the function will attempt to
  * prompt for it.  The function resolves with all of the granted permissions.
  *
- * @deprecated (will be removed in 1.0.0) Use the [Deno Permissions API]{@link https://deno.land/api?s=Deno.Permissions} directly instead.
+ * @deprecated (will be removed in 1.0.0) Use the {@link https://deno.land/api?s=Deno.Permissions | Deno Permissions API} directly instead.
  */
 export async function grant(
   descriptors: Deno.PermissionDescriptor[],
@@ -105,7 +105,7 @@ export async function grant(
  * permission that is denied.  If all permissions are granted, the function
  * will resolve.
  *
- * @deprecated (will be removed in 1.0.0) Use the [Deno Permissions API]{@link https://deno.land/api?s=Deno.Permissions} directly instead.
+ * @deprecated (will be removed in 1.0.0) Use the {@link https://deno.land/api?s=Deno.Permissions | Deno Permissions API} directly instead.
  */
 export async function grantOrThrow(
   ...descriptors: Deno.PermissionDescriptor[]
@@ -122,7 +122,7 @@ export async function grantOrThrow(
  * the denied permissions.  If all permissions are granted, the function will
  * resolve.
  *
- * @deprecated (will be removed in 1.0.0) Use the [Deno Permissions API]{@link https://deno.land/api?s=Deno.Permissions} directly instead.
+ * @deprecated (will be removed in 1.0.0) Use the {@link https://deno.land/api?s=Deno.Permissions | Deno Permissions API} directly instead.
  */
 export async function grantOrThrow(
   descriptors: Deno.PermissionDescriptor[],
diff --git a/ulid/mod.ts b/ulid/mod.ts
index 4dca7931b971..f0c177c226e2 100644
--- a/ulid/mod.ts
+++ b/ulid/mod.ts
@@ -5,7 +5,7 @@
 
 /**
  * Utilities for generating and working with
- * [Universally Unique Lexicographically Sortable Identifiers (ULIDs)]{@link https://github.com/ulid/spec}.
+ * {@link https://github.com/ulid/spec | Universally Unique Lexicographically Sortable Identifiers (ULIDs)}.
  *
  * @module
  */
diff --git a/webgpu/mod.ts b/webgpu/mod.ts
index e6389a8536d3..4929ffc51f5c 100644
--- a/webgpu/mod.ts
+++ b/webgpu/mod.ts
@@ -2,7 +2,7 @@
 
 /**
  * Utilities for interacting with the
- * [WebGPU API]{@link https://developer.mozilla.org/en-US/docs/Web/API/WebGPU_API}.
+ * {@link https://developer.mozilla.org/en-US/docs/Web/API/WebGPU_API | WebGPU API}.
  */
 
 export * from "./create_capture.ts";

From 924642e53c3f0ed9fd42ba27fb12367375e892e7 Mon Sep 17 00:00:00 2001
From: babiabeo <ducthangn71007@gmail.com>
Date: Thu, 25 Jan 2024 20:05:41 +0700
Subject: [PATCH 2/3] add @module tag to webgpu/mod.ts

---
 webgpu/mod.ts | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/webgpu/mod.ts b/webgpu/mod.ts
index 4929ffc51f5c..fe4e6a90da68 100644
--- a/webgpu/mod.ts
+++ b/webgpu/mod.ts
@@ -3,6 +3,8 @@
 /**
  * Utilities for interacting with the
  * {@link https://developer.mozilla.org/en-US/docs/Web/API/WebGPU_API | WebGPU API}.
+ * 
+ * @module
  */
 
 export * from "./create_capture.ts";

From 99d24b32fd49514f18f5f43bed1981334783928c Mon Sep 17 00:00:00 2001
From: babiabeo <ducthangn71007@gmail.com>
Date: Thu, 25 Jan 2024 20:06:49 +0700
Subject: [PATCH 3/3] fmt

---
 webgpu/mod.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/webgpu/mod.ts b/webgpu/mod.ts
index fe4e6a90da68..9d4d56ed94f1 100644
--- a/webgpu/mod.ts
+++ b/webgpu/mod.ts
@@ -3,7 +3,7 @@
 /**
  * Utilities for interacting with the
  * {@link https://developer.mozilla.org/en-US/docs/Web/API/WebGPU_API | WebGPU API}.
- * 
+ *
  * @module
  */