Fce 3087 reorganize docs (#247)

## Reorganized documentation

* renamed `Explanations` to `Concepts`
* renamed `Concepts/Room types explained` to `Rooms`
* renamed `Concepts/Private vs Public Livestreams` to `Livestreams`
* removed `How-to Guides/Features` -> contains sections moved either to
`How-to Guides/Web & Mobile` or `How-to Guides/Backend`
* removed `Troubleshooting` section from `How-to Guides` -> moved the
`Video Codecs` section to
* moved `Tutorials/Gemini Live integration` to new section
`Integrations/` (setting up for the new VAPI section coming in another
PR)

### Also

* updated docusaurus
* updated packages


<img width="309" height="986" alt="image"
src="https://github.com/user-attachments/assets/02a340f3-5c8b-4eca-945b-a7480b524da0"
/>

Author: roznawsk

api/fishjam-server

@@ -178,4 +178,4 @@ Browse the full source: [video-player on GitHub](https://github.com/fishjam-clou
 - Follow the [React Native Quick Start](../tutorials/react-native-quick-start) if you haven't set up a project yet
 - Learn how to [handle screen sharing](../how-to/client/screensharing)
 - Learn how to [implement background streaming](../how-to/client/background-streaming)
-- Learn how to [work with data channels](../how-to/features/text-chat)
+- Learn how to [work with data channels](../how-to/client/text-chat)

api/protos

@@ -46,7 +46,7 @@ yarn dev
 The room component uses `usePeers` to retrieve all participants and renders their video streams using `VideoPlayer` and audio with `AudioPlayer`.
 
 :::note
-This example requires a **peer token** to connect. You need to obtain one yourself — either via the [Sandbox API](../how-to/features/sandbox-api-testing#step-2-create-a-room-and-get-peer-tokens) for quick testing, or by setting up your own backend with the [Fishjam Server SDK](../tutorials/backend-quick-start).
+This example requires a **peer token** to connect. You need to obtain one yourself — either via the [Sandbox API](../how-to/backend/sandbox-api-testing#step-2-create-a-room-and-get-peer-tokens) for quick testing, or by setting up your own backend with the [Fishjam Server SDK](../tutorials/backend-quick-start).
 :::
 
 Browse the full source: [minimal-react on GitHub](https://github.com/fishjam-cloud/examples/tree/main/web-react/minimal-react)
@@ -153,7 +153,7 @@ Smelter requires WebAssembly support — use a modern browser.
 The `useSmelter` hook manages the Smelter engine lifecycle. `registerInput` connects the local camera feed and `registerOutput` routes the composited result back into Fishjam as a custom track.
 
 :::note
-This example requires a **peer token** to connect. You need to obtain one yourself — either via the [Sandbox API](../how-to/features/sandbox-api-testing#step-2-create-a-room-and-get-peer-tokens) for quick testing, or by setting up your own backend with the [Fishjam Server SDK](../tutorials/backend-quick-start).
+This example requires a **peer token** to connect. You need to obtain one yourself — either via the [Sandbox API](../how-to/backend/sandbox-api-testing#step-2-create-a-room-and-get-peer-tokens) for quick testing, or by setting up your own backend with the [Fishjam Server SDK](../tutorials/backend-quick-start).
 :::
 
 Browse the full source: [minimal-smelter on GitHub](https://github.com/fishjam-cloud/examples/tree/main/web-react/minimal-smelter)
@@ -189,5 +189,5 @@ Browse the full source: [fishjam-chat on GitHub](https://github.com/fishjam-clou
 ## Next steps
 
 - Follow the [React Quick Start](../tutorials/react-quick-start) if you haven't set up a project yet
-- Learn how to [work with data channels](../how-to/features/text-chat)
+- Learn how to [work with data channels](../how-to/client/text-chat)
 - Learn how to [implement screen sharing](../how-to/client/screensharing)

api/room-manager

@@ -1,9 +1,9 @@
 {
-  "label": "Explanation",
-  "position": 4,
+  "label": "Concepts",
+  "position": 5,
   "link": {
     "type": "generated-index",
-    "title": "Explanation",
+    "title": "Concepts",
     "description": "Big-picture explanations of higher-level Fishjam concepts. Most useful for building understanding of a particular topic.",
     "slug": "/explanation"
   },

docs/examples/react-native.mdx

@@ -1,7 +1,7 @@
 ---
 type: explanation
 title: Agent Internals
-sidebar_position: 5
+sidebar_position: 6
 description: Deep dive into Fishjam agent architecture, lifecycle, and how to integrate without using a server SDK.
 ---
 

docs/examples/react.mdx

@@ -81,7 +81,7 @@ sequenceDiagram
 
 ## Next Steps
 
-To understand different room types in detail, see [Room Types Explained](../explanation/room-types).
+To understand different room types in detail, see [Rooms](../explanation/rooms).
 
 To learn about security and token management, see [Security & Token Model](../explanation/security-tokens).
 

docs/explanation/_category_.json

@@ -64,4 +64,4 @@ The typical flow is:
 2. Subscribe to incoming messages
 3. Publish messages to other peers
 
-For a complete step-by-step guide on implementing text chat, see [Text Chat](../how-to/features/text-chat).
+For a complete step-by-step guide on implementing text chat, see [Text Chat](../how-to/client/text-chat).

docs/explanation/agent-internals.mdx

@@ -36,4 +36,4 @@ The ID of your Fishjam instance. It is used by your backend server to add peers
 
 ### Sandbox API
 
-A simple testing API allowing you to test Fishjam features without requiring you to add any functionalities to your backend. As the name suggests, it's available **only** in the Sandbox environment. You can find more details [here](/how-to/features/sandbox-api-testing).
+A simple testing API allowing you to test Fishjam features without requiring you to add any functionalities to your backend. As the name suggests, it's available **only** in the Sandbox environment. You can find more details [here](/how-to/backend/sandbox-api-testing).