Unavailable guilds received on GUILD_CREATE

[davfsa]

Description

Someone in our community reported a bug with receiving an unavailable guild on a GUILD_CREATE. I asked around and this has been possible for a while. I haven't had time up to now to have a proper look at it and noticed that the docs specifically state that this should not happen, a GUILD_DELETE should be fired instead.

Would just appreciate some more information on this and whether the documentation should be updated regarding this

Steps to Reproduce

I am uncertain how to reproduce it but all the info I have is that this happened when joining a guild in which a channel was being spammed (potentially making it unavailable).

Expected Behavior

Ideally, should behave according to the documentation (https://discord.com/developers/docs/topics/gateway#guild-create):

Guilds that are unavailable due to an outage will send a Guild Delete event.

Or the documentation should be updated to reflect it

Current Behavior

It seems to be possible to receive a GUILD_CREATE with the payload of a GUILD_DELETE.

Screenshots/Videos

Client and System Information

N/A

[night]

This behavior is not a bug and is working as intended. We could improve documentation to further clarify this behavior.