feat: social hub doc page (#1373)

Co-authored-by: Amy Reeve <amy.reeve@unity3d.com>
Co-authored-by: Vic Cooper <63712500+Vic-Cooper@users.noreply.github.com>
Co-authored-by: amanda-butler-unity <96449283+amanda-butler-unity@users.noreply.github.com>
Co-authored-by: Vic Cooper <vic.cooper@unity3d.com>

Author: 4 people

docs/learn/bitesize/bitesize-introduction.md

@@ -6,10 +6,11 @@ title: About Bitesize samples
 The Bitesize Samples repository provides a series of sample code as modules to use in your games and better understand Netcode for GameObjects (Netcode).
 
 * [Multiplayer Use Cases](bitesize-usecases.md) - Learn more about core Netcode For GameObjects (Netcode) features through practical examples and In-Editor tutorials.
-* [2D Space Shooter Sample](bitesize-spaceshooter.md) - Learn more about physics movement and status effects using Netcode `NetworkVariables` and `ObjectPooling`.
-* [Invaders Sample](bitesize-invaders.md) - Learn more about game flow, modes, unconventional movement networked, and a shared timer.
-* [Client Driven Sample](bitesize-clientdriven.md) - Learn more about Client driven movements, networked physics, spawning vs statically placed objects, object reparenting.
-* [Dynamic Addressables Network Prefabs](bitesize-dynamicprefabs.md) - Learn more about the dynamic prefab system, which allows us to add new spawnable prefabs at runtime.
+* [2D Space Shooter](bitesize-spaceshooter.md) - Learn more about physics movement and status effects using Netcode `NetworkVariables` and `ObjectPooling`.
+* [Invaders](bitesize-invaders.md) - Learn more about game flow, modes, unconventional movement networked, and a shared timer.
+* [Client Driven](bitesize-clientdriven.md) - Learn more about Client driven movements, networked physics, spawning vs statically placed objects, object reparenting.
+* [Dynamic Addressables Network Prefabs](bitesize-dynamicprefabs.md) - Learn more about the dynamic prefab system, which allows you to add new spawnable prefabs at runtime.
+* [Distributed Authority Social Hub](bitesize-socialhub.md) - Learn how to use features of distributed authority like host migration and NetworkObject ownership transfer.
 
 ## Requirements
 

docs/learn/bitesize/bitesize-socialhub.md

@@ -0,0 +1,50 @@
+---
+id: bitesize-socialhub
+title: Distributed Authority Social Hub sample
+description: Learn about the scenes in the Distributed Authority Social Hub sample.
+---
+
+The [Distributed Authority Social Hub Sample](https://github.com/Unity-Technologies/com.unity.multiplayer.samples.bitesize/tree/main/Basic/DistributedAuthoritySocialHub) is a project that demonstrates Distributed Authority's features and helps you integrate Distributed Authority into your own game projects.
+
+Within Social Hub, you can explore Distributed Authority in a sandbox-like environment. You can:
+
+- Automatically redistribute ownership of NetworkObjects across connected clients
+- Experience responsive gameplay through client-side NetworkObject spawning and deferred NetworkObject despawning
+- Transfer ownership of NetworkObjects with variable ownership flags
+- Host migration of a networked game session
+
+## Prerequisites
+
+Social Hub uses services from Unity Gaming Services to facilitate connectivity between players. To use these services inside your project, you must:
+
+1. [Create an organization](https://support.unity.com/hc/en-us/articles/208592876-How-do-I-create-a-new-Unity-organization) inside the Unity Dashboard.
+2. Register your Unity project with that organization's cloud ID. 
+
+## The Bootstrap scene
+
+This is the entry point to the sample. After the Bootstrap scene loads, the MainMenu scene appears.
+
+**Note**: Be sure you have registered the project with a cloud ID.
+
+## The MainMenu scene
+
+To create or join an existing game:
+
+1. Enter a player name and a session name.
+2. Select **Start**.
+
+A successful load indicates that you have correctly registered your project with a cloud ID.
+
+## The HubScene_TownMarket scene
+
+This a sandbox-like environment that supports 64 players. The control model is WASD controls. Move around the level with client-authority, and use **E** to interact with crates and pots. These are NetworkObjects that you can pick up, drop, and throw. Attach one NetworkObject to another with an animated rig through the use of FixedJoints. As a client picks up a NetworkObject, authority of that NetworkObject transfers to that client.
+
+A client has authority over its player NetworkObject. Therefore, the movement, animations, and interactions that a client performs are client-authoritative.
+
+This sample inherently supports host migration out of the box. Load multiple clients, and witness the automatic distribution of ownership of NetworkObjects when the original session owner leaves the session.
+
+## Additional resources
+
+- Get help and ask questions on [Multiplayer Discussions](https://discussions.unity.com/lists/multiplayer).
+- Join the community of Multiplayer creators on the [Multiplayer Networking Discord](https://discord.gg/unity-multiplayer-network).
+- [Request a feature or report a bug](https://github.com/Unity-Technologies/com.unity.multiplayer.samples.bitesize/issues/new/choose).

docs/terms-concepts/distributed-authority.md

@@ -50,3 +50,4 @@ For more information about how distributed authority works in Netcode for GameOb
 - [Race conditions](../basics/race-conditions.md)
 - [Spawning synchronization](../basics/spawning-synchronization.md)
 - [Deferred despawning](../basics/deferred-despawning.md)
+- [Distributed Authority Social Hub sample](../learn/bitesize/bitesize-socialhub.md)

sidebars.js

@@ -578,6 +578,10 @@ module.exports = {
                             "type": "doc",
                             "id": "learn/bitesize/bitesize-dynamicPrefabs"
                         },
+                        {
+                            "type": "doc",
+                            "id": "learn/bitesize/bitesize-socialhub"
+                        },
                     ]
                 },
                 {