Updated identify connection fields to match deprecation status. (#5067)

* Updated identify connection fields to match deprecation status.

It is expected that these field names will be supported for a while, but it is recommended to all consumers to update to unprefixed fields.

* Update docs/topics/Gateway.md

* add identify changelog

* ayyy explicit api versions

* Update docs/topics/Gateway.md

Co-authored-by: Zoddo <[email protected]>

Co-authored-by: Shay <[email protected]>
Co-authored-by: Shay DeWael <[email protected]>
Co-authored-by: Zoddo <[email protected]>

Author: 3 people

docs/Change_Log.md

@@ -1,5 +1,13 @@
 # Change Log
 
+## Updated Connection Property Field Names
+
+#### Jun 17, 2022
+
+The `$` prefix in [identify connection properties](#DOCS_TOPICS_GATEWAY/identify-identify-connection-properties) are deprecated. The new field names are `os`, `browser`, and `device`. When passed, the `$`-prefixed names will resolve to the new ones. 
+
+In API v11, support for the previous field names (`$os`, `$browser`, and `$device`) will be removed.
+
 ## Auto Moderation
 
 #### Jun 16, 2022

docs/topics/Gateway.md

@@ -154,9 +154,9 @@ This is a minimal `IDENTIFY` payload. `IDENTIFY` supports additional optional fi
     "token": "my_token",
     "intents": 513,
     "properties": {
-      "$os": "linux",
-      "$browser": "my_library",
-      "$device": "my_library"
+      "os": "linux",
+      "browser": "my_library",
+      "device": "my_library"
     }
   }
 }
@@ -570,11 +570,14 @@ Used to trigger the initial handshake with the gateway.
 
 ###### Identify Connection Properties
 
-| Field     | Type   | Description           |
-| --------- | ------ | --------------------- |
-| \$os      | string | your operating system |
-| \$browser | string | your library name     |
-| \$device  | string | your library name     |
+| Field   | Type   | Description           |
+| ------- | ------ | --------------------- |
+| os      | string | your operating system |
+| browser | string | your library name     |
+| device  | string | your library name     |
+
+> warn
+> These fields originally were $ prefixed (i.e: `$browser`) but [this syntax is deprecated](#DOCS_CHANGE_LOG/updated-connection-property-field-names). While they currently still work, it is recommended to move to non-prefixed fields.
 
 ###### Example Identify
 
@@ -584,9 +587,9 @@ Used to trigger the initial handshake with the gateway.
   "d": {
     "token": "my_token",
     "properties": {
-      "$os": "linux",
-      "$browser": "disco",
-      "$device": "disco"
+      "os": "linux",
+      "browser": "disco",
+      "device": "disco"
     },
     "compress": true,
     "large_threshold": 250,