[FCE-1172][FCE-1171] Add links to Room Manager (and clarify various things) (#90)

## Description

Update various parts of documentation to make Room Manager usage easier
to understand.

Author: mironiasty

docs/glossary.md

@@ -8,32 +8,28 @@ A brief walk-through of the terms we use in the documentation.
 
 ### Room
 
-Collection of peers that can send and receive video/audio to and from other peers
+A collection of peers that can send and receive video/audio to and from other peers.
 
 ### Peer
 
-User that is connected to a room. Each peer has some associated metadata and tracks.
+A user that is connected to a room. Each peer has some associated metadata and tracks.
 
 ### Track
 
-Single stream of video or audio of a peer. It could be a camera view, shared screen or microphone audio. Each peer can  
-stream multiple tracks.
+A single stream of video or audio from a peer. It could be a camera view, shared screen, or microphone audio. Each peer can stream multiple tracks.
 
 ### Management Token
 
-Secret token that should be stored on your backend. It allows to create rooms and add peers.
+A secret token that should be stored on your backend. It allows you to create rooms and add peers.
 
 ### Peer Token
 
-Token that your backend should pass to end clients to allow access to a specific room.
+A token that your backend should pass to end clients to allow access to a specific room.
 
 ### Fishjam URL
 
-URL to your Fishjam instance. It is used by your backend server to add peers to rooms (and create rooms).  
-It is also
-used by end client apps to join rooms.
+The URL to your Fishjam instance. It is used by your backend server to add peers to rooms (and create rooms). It is also used by end client apps to join rooms.
 
 ### Room Manager
 
-Our test app available **only** on Sandbox environment. It allows to test Fishjam without need to add create rooms
-functionality on your backend.
+Our test app is available **only** in the Sandbox environment. It allows you to test Fishjam without needing to add room creation functionality to your backend. You can find more details [here](/room-manager).

docs/introduction.mdx

@@ -7,20 +7,20 @@ import { items } from "@site/src/content/cardItems";
 
 # Introduction
 
-Welcome to Fishjam documentation!  
+Welcome to the Fishjam documentation!  
 Here you will find everything you need to start building your multimedia streaming applications using Fishjam.
 
 ## What is Fishjam?
 
 Fishjam is a multimedia streaming toolkit that allows you to build real-time video and audio streaming applications using [WebRTC](https://developer.mozilla.org/en-US/docs/Web/API/WebRTC_API).
-We provide the infrastructure, media server and client SDKs so you can focus on building your apps.
+We provide the infrastructure, media server, and client SDKs so you can focus on building your apps.
 
 **No WebRTC knowledge is required!**
 
 ## How can I try it out?
 
 1. To get started with Fishjam, you need to create an account on our [developer panel](https://fishjam.io/app).
-2. Once you have an account, Fishjam will assign you a sandbox instance automatically. Sandbox instances come with [**Room Manager**](/room-manager.md) - a simple backend for creating test rooms. Copy the _Fishjam URL_ and _Management Token_ from the developer panel.
+2. Once you have an account, Fishjam will assign you a Sandbox instance automatically. Sandbox instances come with [**Room Manager**](/room-manager.md) - a simple backend for creating test rooms. Copy the Room Manager URL from the developer panel.
 3. Pick a client SDK that you want to use and follow the Quick Start guide. We provide SDKs for [React Native](/react-native/quick-setup.mdx) and [React](/react/installation.mdx).
 
 <QuickNavigation
@@ -32,9 +32,9 @@ We provide the infrastructure, media server and client SDKs so you can focus on
 We are maintaining a simple video conferencing app called [Videoroom](https://room.fishjam.io/).
 It is a publicly accessible app where you can see Fishjam in action.
 
-You can access it at [room.fishjam.io](https://room.fishjam.io/) - just pick a room name and peer name and you can start a video call between any two devices.
+You can access it at [room.fishjam.io](https://room.fishjam.io/) - just pick a room name and peer name, and you can start a video call between any two devices.
 
-## Any examples I can run locally?
+## Are there any examples I can run locally?
 
 Yes! You can find examples in our GitHub repositories that you can run locally. Examples are usually available under the `examples` directory in the relevant repository.
 

docs/react-native/connecting.mdx

@@ -11,22 +11,22 @@ This article will guide you through the process of connecting to a Fishjam room.
 
 ## Getting URL and token
 
-In order to connect, you need to retrieve `FISHJAM_URL` (multimedia server address) and `PEER_TOKEN` (token that will authenticate the peer in
+In order to connect, you need to retrieve the **Fishjam URL** and **Peer Token** (the token that will authenticate the peer in
 your Room).
 
 <Tabs groupId="app-type">
 
   <TabItem value="sandbox" label="Sandbox App">
 
-Once you get your account on [Fishjam](https://fishjam.io), you will have access to Sandbox App. This app comes
-with pre-configured test service called Room Manager. This is basically service that will create Room, add your app as
-Room's Peer and return token required to use that Room.
+Once you get your account on [Fishjam](https://fishjam.io), you will have access to the Sandbox App. This app comes
+with a pre-configured test service called [Room Manager](/room-manager). This is basically a service that will create a Room, add your app as
+the Room's Peer, and return the token required to use that Room.
 
-To use that simply call `fetch`:
+To use that, simply call `fetch`:
 
 ```ts
 const response = await fetch(
-  `https://fishjam.io/api/v1/connect/${YOUR_ID}/room-manager/?roomName=${roomName}&peerName=${peerName}`,
+  `https://fishjam.io/api/v1/connect/${SANDBOX_APP_UUID}/room-manager/?roomName=${roomName}&peerName=${peerName}`,
 );
 
 const { fishjamUrl, peerToken } = await response.json();
@@ -35,22 +35,22 @@ const { fishjamUrl, peerToken } = await response.json();
   </TabItem>
   <TabItem value="production" label="Production App">
 
-For production app, you need to implement your own backend service that will provide user with `PEER_TOKEN`. To do that,
+For the production app, you need to implement your own backend service that will provide the user with a **Peer Token**. To do that,
 follow our [server setup instructions](/production/server).
 
   </TabItem>
 </Tabs>
 
 ## Connecting
 
-In order to connect, call [`joinRoom`](/api/mobile/functions/useConnection#joinroom) method with data from previous step:
+In order to connect, call [`joinRoom`](/api/mobile/functions/useConnection#joinroom) method with data from the previous step:
 
 ```tsx
 import { useCallback } from "react";
 import { Button } from "react-native";
 import { useConnection } from "@fishjam-cloud/react-native-client";
 
-// check https://cloud.fishjam.work/app/ for your app ID
+// Check https://cloud.fishjam.work/app/ for your app ID
 const YOUR_APP_ID = "...";
 
 export function JoinRoomButton() {
@@ -68,7 +68,7 @@ export function JoinRoomButton() {
 }
 
 async function getRoomDetails(roomName: string, peerName: string) {
-  // this will work ONLY for sandbox app
+  // This will work ONLY for the Sandbox App
   const response = await fetch(
     `https://fishjam.io/api/v1/connect/${YOUR_APP_ID}/room-manager/?roomName=${roomName}&peerName=${peerName}`,
   );

docs/react-native/installation.mdx

@@ -9,7 +9,7 @@ import ConfigurePermissions from "./_components/configure-permissions.mdx";
 
 # Installation
 
-## Optional: Create new App
+## Optional: Create a New App
 
 <details>
   <summary>Follow these steps to create a new mobile app</summary>
@@ -20,25 +20,29 @@ If you don't have an existing project, you can create a new Expo app using a tem
 npx create-expo-app@latest my-video-app
 ```
 
-As the next step, you have to generate native files with `expo prebuild` command:
+As the next step, you have to generate native files with the `expo prebuild` command:
 
 ```bash
 npx expo prebuild
 ```
 
-You can also follow more detailed [expo instructions](https://docs.expo.dev/get-started/introduction/).
+You can also follow more detailed [Expo instructions](https://docs.expo.dev/get-started/introduction/).
 
 </details>
 
-## Step 1: Install the package
+## Step 1: Install the Package
+
+Install `@fishjam-cloud/react-native-client` with your preferred package manager.
 
 <InstallPackage />
 
-## Step 2: Configure App permissions
+## Step 2: Configure App Permissions
 
 <ConfigurePermissions />
 
-## Step 3: Request app permissions
+## Step 3: Request App Permissions
+
+Before using the camera or microphone, ask the user for permissions.
 
 ```tsx
 import { useCameraPermissions } from "expo-camera";

docs/react-native/quick-setup.mdx

@@ -8,12 +8,12 @@ import ConfigurePermissions from "./_components/configure-permissions.mdx";
 # Quick Setup
 
 This article is a fast track to integrate Fishjam into your React Native application.  
-It contains all required steps to start streaming video with Fishjam.  
+It contains all the required steps to start streaming video with Fishjam.  
 You can also [see a full example](#full-example) at the end of the article.
 
 ## Prerequisites
 
-In this part, let's focus on all the things you need to prepare to use Fishjam in your project.
+In this part, let's focus on everything you need to prepare to use Fishjam in your project.
 
 ### 1. Install the package
 
@@ -31,16 +31,16 @@ npx expo prebuild
 
 ### 4. Get Room Manager URL
 
-Login to [Fishjam Dashboard](https://fishjam.io/app) and get your [Room Manager](/glossary#room-manager) URL.
+Log in to [Fishjam Dashboard](https://fishjam.io/app) and get your [Room Manager](/room-manager) URL.
 
-## Step by step instructions
+## Step-by-step instructions
 
 Now you are good to jump right into your IDE and integrate Fishjam into your app.
-In few simple steps, you will be able to implement a simple video call functionality.
+In a few simple steps, you will be able to implement a simple video call functionality.
 
 ### 1. Fetch peer token
 
-Use your room manager URL to fetch peer token to get a new room:
+Use your Room Manager URL to fetch a peer token to get a new room:
 
 ```ts
 const response = await fetch(
@@ -61,7 +61,7 @@ If you want to use the camera, you must first request permission. Check
 
 :::important
 
-Keep in mind that this won't work on iOS Simulator, as Simulator can't access the camera.
+Keep in mind that this won't work on the iOS Simulator, as the Simulator can't access the camera.
 
 :::
 
@@ -103,7 +103,7 @@ export function StartStreamingButton({
 
 ### 3. Check if you are connected
 
-Once you are connected, you can check connection status with [`useConnection`](/api/mobile/functions/useConnection) hook
+Once you are connected, you can check the connection status with [`useConnection`](/api/mobile/functions/useConnection) hook
 
 ```ts
 const { peerStatus } = useConnection();
@@ -154,7 +154,7 @@ Here is how it all could work together:
 
 :::info
 
-We are using `expo-camera` to request camera permissions in example app. You can install and build it using the
+We are using `expo-camera` to request camera permissions in the example app. You can install and build it using the
 following command:
 
 ```bash

docs/react/connecting.mdx

@@ -6,7 +6,7 @@ sidebar_position: 2
 
 ## Prerequisites
 
-In order to connect, you need a `PEER_TOKEN` and the `FISHJAM_URL`.
+In order to connect, you need a **Peer Token** and the **Fishjam URL**.
 
 ## Connecting
 

docs/room-manager.md

@@ -4,26 +4,28 @@ sidebar_position: 4
 
 # Room Manager
 
-The **default sandbox app** comes with an HTTP server called **Room Manager**.
-It allows you to start working on the Client App without having to setup an actual backend.
-However, for production purposes, you need to bring own backend using our Server SDKs. Production apps doesn't have a corresponding Room Manager.
+## App for Initial Development
+
+The [**default Sandbox App**](https://fishjam.io/app/sandbox) comes with an HTTP server called **Room Manager**.
+It allows you to start working on the Client App without having to set up an actual backend.
+However, for production purposes, you need to bring your own backend using our Server SDKs. Production apps don't have a corresponding Room Manager.
 
 :::danger[ROOM MANAGER IS NOT SAFE FOR PRODUCTION]
 
 Room Manager doesn't implement any form of authentication.
 Anyone using the same room name and peer name will receive **the same Peer Token!**
 
-For production environment, make sure to [set up your own backend](/production/server.mdx) using our Server SDKs and authenticate the client on your own.
+For a production environment, make sure to [set up your own backend](/production/server.mdx) using our Server SDKs and authenticate the client on your own.
 
 :::
 
-## Why should I use it?
+## Why Should I Use It?
 
 If you're a frontend developer and you want to quickly test your app, you can use the Room Manager to create a room and access it.
-This way you can start building your app without having to deploy any server side logic.
+This way, you can start building your app without having to deploy any server-side logic.
 
 :::note
-When moving to production, the only change you will need to make is to retrieve the **peer token from your backend** instead of the room manager.
+When moving to production, the only change you will need to make is to retrieve the **peer token from your backend** instead of the Room Manager.
 :::
 
 :::tip
@@ -34,18 +36,22 @@ It can be used as a reference for building your backend.
 
 :::
 
-## How do I use it?
+## How Do I Use It?
 
-Simply take the Fishjam instance url of your `sandbox` app, which should look like `https://fishjam.io/api/v1/connect/***`, append a
-`/room-manager` path and use `roomName` and `peerName` query params to build an url for the GET request.
+Simply log in to your Fishjam Dashboard and open the [Sandbox App](https://fishjam.io/app/sandbox). You will see your Room Manager URL there.
+Now you need to add `roomName` and `peerName` query params to build a URL for the GET request.
 
-#### Example GET request url
+#### Example GET Request URL
 
 ```
 https://fishjam.io/api/v1/connect/<YOUR_APP_UUID>/room-manager?roomName=foo&peerName=bar
 ```
 
-#### Example response
+:::note
+`YOUR_APP_UUID` is your unique ID. Anyone who knows that ID can join your rooms. To reset this ID, you have to open the Sandbox App, press Settings, and Reset App.
+:::
+
+#### Example Response
 
 ```json
 {