Skip to content

docs: several broken links across library need updating #1533

@AsadHumayun

Description

@AsadHumayun

Issue description

I believe the recent update to Discord's documentation site may have lead to various links in this package being broken as a result.

Below are some examples of only the links that I found were broken. I suspect there could be more and am not entirely aware of the full scope that this has affected the docs here yet - some links seem to work just fine, and some are broken.

E.x.:

/**
* Types extracted from https://discord.com/developers/docs/topics/gateway
*/

/**
* You sent an invalid Gateway opcode or an invalid payload for an opcode. Don't do that!
*
* @see {@link https://discord.com/developers/docs/topics/gateway-events#payload-structure}
*/

...and in other versions:

* Types extracted from https://discord.com/developers/docs/topics/gateway

...and in payloads:

*
* @see List of member-related events {@link https://discord.com/developers/docs/topics/gateway#list-of-intents | under `GUILD_MEMBERS`}
*/

I'm not sure as to whether there is an automated process to this - I can imagine it being quite challenging to go through everything.

I did want to raise this as it does affect the library quite severely; many links will 404 which can significantly hurt developer experience.

Code sample

N/A

Package version

0.38.40

Runtime

Node.js

Runtime version

v25.2.1

Priority this issue should have

Medium (should be fixed soon)

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions