[clans] Adds documentation for user clan information

[hammerdr]

trafficstars

Users can join Guilds (called clans in documentation) and as part of that process can adopt the guild's tag as their own. This tag is displayed in the client next to their name.

This documents the clan tags that might come down on the user object. Clans are a feature that is not yet released, so this is subject to change.

In addition, the full clan object is not yet documented because it is still in development. This is just the tag that will be displayed next to the user's name.

---

• To see the specific tasks where the Asana app for GitHub is being used, see below:
  • https://app.asana.com/0/0/1210467268571409

[cobaltt7]

Will there be an option for server owners to disable showing clan tags in their server? I feel like messages would get quite cluttered otherwise, especially for servers completely unrelated to gaming.

[Lulalaby]

Agreed, that should be definitely kept in mind. A message author can currently have

• their name
• a role icon
• a app / verified app tag
• a linked role badge

Additionally, to have a clan badge next to it would fill the whole author line probably at some point.

[MinnDevelopment]

Why was this naming convention approved? This is going to cause a ton of confusion for every new developer. Now we have two naming discrepancies that are even conflicting. Server -> Guild and Guild -> Clan. I'm really disappointed in this decision and dread the amount of confusion this will cause.

[sumeetv]

Hey everyone, I'm one of the engineering leads of the team testing this feature out. We understand the confusion around guilds and server terminology. This is just an experiment at this time. If we decide to roll this out more broadly after the experiment concludes, we intend to come up with a better name that will be consistent across our Developer API and how we refer to it in the product. We know this might cause some confusion while the experiment is live and intend to clean things up soon. Thanks!

[MCausc78]

curious, but why some fields in user.clan in interaction.resolved.messages[x] and GET /users/{user.id} are null? Happens with some users

{
  "type": 0,
  "tts": false,
  "timestamp": "2024-05-19T17:21:27.550000+00:00",
  "pinned": false,
  "mentions": [],
  "mention_roles": [],
  "mention_everyone": false,
  "id": "1241802919326646283",
  "flags": 0,
  "embeds": [],
  "edited_timestamp": null,
  "content": "haven't seen you in a while",
  "components": [],
  "channel_id": "1241787241014104136",
  "author": {
    "username": "pukima",
    "public_flags": 4194432,
    "id": "751092600890458203",
    "global_name": "Pukima",
    "discriminator": "0",
    "clan": {
      "tag": null,
      "identity_guild_id": null,
      "identity_enabled": false,
      "badge": null
    },
    "avatar_decoration_data": {
      "sku_id": "1144307629225672846",
      "asset": "a_d72066b8cecbadd9fc951913ebcc384f"
    },
    "avatar": "b7e2f5461e61512674abc06c3d0264b7"
  },
  "attachments": []
}