docs: differ User#send

packages/discord.js/src/structures/User.js

@@ -305,12 +305,59 @@ class User extends Base {
     json.bannerURL = this.banner ? this.bannerURL() : this.banner;
     return json;
   }
-
-  // These are here only for documentation purposes - they are implemented by TextBasedChannel
-  /* eslint-disable no-empty-function */
-  send() {}
 }
 
+/**
+ * Sends a message to this user.
+ * @method send
+ * @memberof User
+ * @instance
+ * @param {string|MessagePayload|MessageCreateOptions} options The options to provide
+ * @returns {Promise<Message>}
+ * @example
+ * // Send a direct message
+ * user.send('hello!')
+ *   .then(message => console.log(`Sent message: ${message.content}`))
+ *   .catch(console.error);
+ * @example
+ * // Send a remote file
+ * user.send({
+ *   files: ['https://cdn.discordapp.com/icons/222078108977594368/6e1019b3179d71046e463a75915e7244.png?size=2048']
+ * })
+ *   .then(console.log)
+ *   .catch(console.error);
+ * @example
+ * // Send a local file
+ * user.send({
+ *   files: [{
+ *     attachment: 'entire/path/to/file.jpg',
+ *     name: 'file.jpg',
+ *     description: 'A description of the file'
+ *   }]
+ * })
+ *   .then(console.log)
+ *   .catch(console.error);
+ * @example
+ * // Send an embed with a local image inside
+ * user.send({
+ *   content: 'This is an embed',
+ *   embeds: [
+ *     {
+ *       thumbnail: {
+ *         url: 'attachment://file.jpg'
+ *       }
+ *     }
+ *   ],
+ *   files: [{
+ *     attachment: 'entire/path/to/file.jpg',
+ *     name: 'file.jpg',
+ *     description: 'A description of the file'
+ *   }]
+ * })
+ *   .then(console.log)
+ *   .catch(console.error);
+ */
+
 TextBasedChannel.applyToClass(User);
 
 module.exports = User;