From f02bdc3be37bbcae97991df0693531b93da447d4 Mon Sep 17 00:00:00 2001
From: Souji <timoqueezle@gmail.com>
Date: Tue, 5 Nov 2024 10:29:29 +0100
Subject: [PATCH] docs: add note about idempotence to role add/remove routes
 (#10586)

* chore(docs): Add note about idempotence to role add/remove routes

* chore: remove trailing spaces
---
 packages/discord.js/src/managers/GuildMemberRoleManager.js | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/discord.js/src/managers/GuildMemberRoleManager.js b/packages/discord.js/src/managers/GuildMemberRoleManager.js
index e5302683d..7d19bf778 100644
--- a/packages/discord.js/src/managers/GuildMemberRoleManager.js
+++ b/packages/discord.js/src/managers/GuildMemberRoleManager.js
@@ -101,6 +101,8 @@ class GuildMemberRoleManager extends DataManager {
 
   /**
    * Adds a role (or multiple roles) to the member.
+   *
+   * <info>Uses the idempotent PUT route for singular roles, otherwise PATCHes the underlying guild member</info>
    * @param {RoleResolvable|RoleResolvable[]|Collection<Snowflake, Role>} roleOrRoles The role or roles to add
    * @param {string} [reason] Reason for adding the role(s)
    * @returns {Promise<GuildMember>}
@@ -138,6 +140,8 @@ class GuildMemberRoleManager extends DataManager {
 
   /**
    * Removes a role (or multiple roles) from the member.
+   *
+   * <info>Uses the idempotent DELETE route for singular roles, otherwise PATCHes the underlying guild member</info>
    * @param {RoleResolvable|RoleResolvable[]|Collection<Snowflake, Role>} roleOrRoles The role or roles to remove
    * @param {string} [reason] Reason for removing the role(s)
    * @returns {Promise<GuildMember>}