PHPDocs

Author: valzargaming

src/Discord/Parts/Guild/NewMemberAction.php

@@ -24,20 +24,22 @@
  *
  * @since 10.47.0 OpenAPI Preview
  *
- * @property string|null $channel_id  The target channel id.
- * @property int         $action_type The action type (0 = VIEW, 1 = TALK).
- * @property string      $title       The action title.
- * @property string      $description The action description.
- * @property Emoji|null  $emoji       The partial emoji associated with the action.
- * @property string|null $icon        The icon string, if present.
+ * @property string|null $channel_id  The ID of the channel where the action is located.
+ * @property int         $action_type The type of action the user should take in the channel (0 = VIEW, 1 = TALK).
+ * @property string      $title       The title of the action (max 60 characters).
+ * @property string      $description The description of the action (max 200 characters).
+ * @property Emoji|null  $emoji       The partial emoji representing the action.
+ * @property string|null $icon        The icon hash representing the action.
  *
  * @property-read string|null  $guild_id The guild id associated with this action.
  * @property-read Guild|null   $guild    The guild associated with this action.
  * @property-read Channel|null $channel  The channel associated with this action.
  */
 class NewMemberAction extends Part
 {
+    /** View the channel. */
     public const ACTION_TYPE_VIEW = 0;
+    /** Send a message in the channel. */
     public const ACTION_TYPE_TALK = 1;
 
     /**

src/Discord/Parts/Guild/ServerGuide.php

@@ -20,15 +20,17 @@
 /**
  * Server Guide for a guild.
  *
+ * Previously known as GuildHome.
+ *
  * @link https://github.com/discord/discord-api-spec/blob/7cba79e03a393456fc904cff470097d3be383bec/specs/openapi_preview.json#L25369
  *
  * @since 10.47.0 OpenAPI Preview
  *
- * @property string                                                   $guild_id           The guild (server) id.
- * @property bool                                                     $enabled            Whether Home is enabled for the guild.
- * @property WelcomeMessage|null                                      $welcome_message    The welcome message settings.
- * @property ExCollectionInterface<NewMemberAction>|NewMemberAction[] $new_member_actions The new member actions.
- * @property ExCollectionInterface<ResourceChannel>|ResourceChannel[] $resource_channels  The resource channels.
+ * @property string                                                   $guild_id           The ID of the guild this new member welcome is for.
+ * @property bool                                                     $enabled            Whether the new member welcome experience is enabled.
+ * @property WelcomeMessage|null                                      $welcome_message    Welcome message shown to new members of the guild.
+ * @property ExCollectionInterface<NewMemberAction>|NewMemberAction[] $new_member_actions Actions shown to new members of the guild (max 5).
+ * @property ExCollectionInterface<ResourceChannel>|ResourceChannel[] $resource_channels  Read-only channels that provide resources for new members (max 7).
  *
  * @property-read Guild|null $guild The guild associated with the server guide.
  */

src/Discord/Parts/Guild/WelcomeMessage.php

@@ -23,8 +23,8 @@
  *
  * @since 10.47.0 OpenAPI Preview
  *
- * @property string[] $author_ids The author IDs for the message.
- * @property string   $message    The welcome message content.
+ * @property string[] $author_ids The IDs of the users who authored the welcome message (max 10).
+ * @property string   $message    The welcome message shown to new members (max 300 characters).
  */
 class WelcomeMessage extends Part
 {