Edit the organize doc (netdata#19101)

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

docs/dashboards-and-charts/dashboards-tab.md

@@ -41,7 +41,7 @@ Charts also synchronize as you interact with them, even across contexts _or_ nod
 
 ### Text cards
 
-You can use text cards as notes to explain to other members of the [Room](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#netdata-cloud-rooms) the purpose of the dashboard's arrangement.
+You can use text cards as notes to explain to other members of the [Room](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#rooms) the purpose of the dashboard's arrangement.
 
 By clicking the `T` icon on the text box, you can switch between font sizes.
 

docs/dashboards-and-charts/nodes-tab.md

@@ -1,6 +1,6 @@
 # Nodes tab
 
-The nodes tab provides a summarized view of your [Room](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#netdata-cloud-rooms), allowing you to view quick information per node.
+The nodes tab provides a summarized view of your [Room](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#rooms), allowing you to view quick information per node.
 
 > **Tip**  
 >

docs/glossary.md

@@ -25,10 +25,6 @@ Use the alphabetized list below to find the answer to your single-term questions
 
 - [**Anomaly Advisor**](/docs/dashboards-and-charts/anomaly-advisor-tab.md): A Netdata feature that lets you focus on potentially anomalous metrics and charts related to a particular highlight window of interest.
 
-## B
-
-- [**Bookmarks**](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#manage-spaces): Netdata Cloud's bookmarks put your tools in one accessible place. Bookmarks are shared between all Rooms in a Space, so any users in your Space will be able to see and use them.
-
 ## C
 
 - [**Child**](/docs/observability-centralization-points/metrics-centralization-points/README.md): A node, running Netdata, that streams metric data to one or more parent.
@@ -123,13 +119,13 @@ metrics, troubleshoot complex performance problems, and make data interoperable
 
 - [**Replication Streaming**](/src/streaming/README.md): Streaming configuration where child `A`, _with_ a database and web dashboard, streams metrics to parent `B`.
 
-- [**Room**](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#netdata-cloud-rooms): Rooms organize your connected nodes and provide infrastructure-wide dashboards using real-time metrics and visualizations.
+- [**Room**](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#rooms): Rooms organize your connected nodes and provide infrastructure-wide dashboards using real-time metrics and visualizations.
 
 ## S
 
 - [**Single Node Dashboard**](/docs/dashboards-and-charts/metrics-tab-and-single-node-tabs.md): A dashboard pre-configured with every installation of the Netdata Agent, with thousand of metrics and hundreds of interactive charts that requires no set up.
 
-- [**Space**](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#netdata-cloud-spaces): A high-level container and virtual collaboration area where you can organize team members, access levels,and the nodes you want to monitor.
+- [**Space**](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#spaces): A high-level container and virtual collaboration area where you can organize team members, access levels,and the nodes you want to monitor.
 
 ## T
 

docs/netdata-agent/configuration/organize-systems-metrics-and-alerts.md

@@ -5,10 +5,10 @@ Netdata allows organizing your observability infrastructure with Spaces, Rooms,
 
 ## Spaces and Rooms
 
-[Spaces](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#netdata-cloud-spaces) are used for organization-level or infrastructure-level
+[Spaces](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#spaces) are used for organization-level or infrastructure-level
 grouping of nodes and people. A node can only appear in a single space, while people can have access to multiple spaces.
 
-The [Rooms](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#netdata-cloud-rooms) in a space bring together nodes and people in
+The [Rooms](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#rooms) in a space bring together nodes and people in
 collaboration areas. Rooms can also be used for fine-tuned
 [role-based access control](/docs/netdata-cloud/authentication-and-authorization/role-based-access-model.md).
 

docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md

@@ -1,62 +1,118 @@
-# Organize Your Infrastructure and Invite your Team
+# Spaces and Rooms
 
-Netdata Cloud works with [Spaces](#netdata-cloud-spaces) and [Rooms](#netdata-cloud-rooms). They allow you to better organize your infrastructure and provide the right access to your team.
+This guide explains how to effectively organize your infrastructure monitoring using Netdata Cloud.
 
-## Netdata Cloud Spaces
+Netdata Cloud uses two primary organizational concepts:
 
-A Space is a high-level container. It's a collaboration environment where you can organize team members, access levels and the nodes you want to monitor.
+- [Spaces](#spaces): High-level containers for your entire infrastructure.
+- [Rooms](#rooms): Flexible groupings within Spaces for specific monitoring needs.
 
-### How to organize your Netdata Cloud Environment
+## Spaces
 
-You can use any number of Spaces you want, but as you organize your Cloud experience, keep in mind that you can only add any given node to a **single** Space.
+**What is a Space?**
 
-We recommend sticking to a single Space so that you can keep all your nodes and their respective metrics in one place. You can then use multiple [Rooms](#netdata-cloud-rooms) to further organize your infrastructure monitoring.
+Space serves as your primary collaboration environment in Netdata Cloud. It allows you to:
 
-### Navigate between Spaces
+- Organize team members and manage access levels.
+- Connect nodes for monitoring.
+- Create a unified monitoring environment.
 
-You can navigate through your different Spaces by using the left-most bar of the interface. From there you can also create a new Space by clicking the plus **+** icon.
+**Key Space Characteristics**
 
-![image](https://github.com/netdata/netdata/assets/70198089/74f622ac-07bf-40c7-81ba-f3907ed16c42)
+- Each node can only belong to **one** Space.
+- You can create multiple Spaces, but we recommend using a single Space for most use cases.
+- All team members in a Space can access its monitoring data based on their assigned roles.
 
-### Manage Spaces
+### Space Management
 
-Manage your spaces by selecting a particular space and clicking on the gear icon in the lower left-hand corner. This will open the Space's settings view, where you can take a multitude of actions regarding the Space's Rooms, nodes, integrations, configurations, and more.
+**Navigation**
 
-## Netdata Cloud Rooms
+1. Use the left-most sidebar to switch between Spaces.
+2. Click the plus (**+**) icon to create a new Space.
 
-Spaces use Rooms to organize your connected nodes and provide infrastructure-wide dashboards using real-time metrics and visualizations.
+**Settings and Configuration**
 
-**A node can be in N Rooms.**
+1. Select your Space.
+2. Click the gear icon in the lower left corner.
+3. Access settings for:
+    - Room management.
+    - Node configuration.
+    - Integration setup.
+    - General Space settings.
 
-Once you add nodes to a Space, all of your nodes will be visible in the **All nodes** Room. It gives you an overview of all of your nodes in this particular Space. Then you can create functional separations of your nodes into more Rooms. Every Room has its own dashboards, navigation, indicators, and management tools.
+## Rooms
 
-### Room organization
+**What is a Room?**
 
-We recommend a few strategies for organizing your Rooms.
+Rooms are organizational units within a Space that provide:
 
-- **Service, purpose, location, etc.**  
-   You can group Rooms by a service (Nginx, MySQL, Pulsar, and so on), their purpose (webserver, database, application), their physical location, whether they're "bare metal" or a Docker container, the PaaS/cloud provider it runs on, and much more. This allows you to see entire slices of your infrastructure by moving from one Room to another.
+- Infrastructure-wide dashboards.
+- Real-time metrics visualization.
+- Focused monitoring views.
+- Flexible node grouping.
 
-- **End-to-end apps/services**  
-  If you have a user-facing SaaS product, or an internal service that this said product relies on, you may want to monitor that entire stack in a single Room. This might include Kubernetes clusters, Docker containers, proxies, databases, web servers, brokers, and more. End-to-end Rooms are valuable tools for ensuring the health and performance of your organization's essential services.
+**Key Room Characteristics**
 
-- **Incident response**  
-  You can also create new Rooms as one of the first steps in your incident response process. For example, you have a user-facing web app that relies on Apache Pulsar for a message queue, and one of your nodes using the [Pulsar collector](/src/go/plugin/go.d/collector/pulsar/README.md) begins reporting a suspiciously low messages rate. You can create a Room called `$year-$month-$day-pulsar-rate`, add all your Pulsar nodes in addition to nodes they connect to, and begin diagnosing the root cause in a Room optimized for getting to resolution as fast as possible.
+- A node can belong to **multiple** Rooms.
+- All nodes automatically appear in the "All nodes" Room.
+- Each Room has independent dashboards and monitoring tools.
 
-### Add Rooms
+### Room Organization Strategies
 
-To add new Rooms to any Space, click on the green plus icon **+** next to the **Rooms** heading on the Room's sidebar.
+1. **Service-Based Organization**
 
-### Manage Rooms
+   Group nodes by:
+    - Specific services (Nginx, MySQL, Pulsar).
+    - Purpose (webserver, database, application).
+    - Physical location.
+    - Infrastructure type (bare metal, containers).
+    - Cloud provider.
 
-All the users and nodes involved in a particular Space can be part of a Room.
+2. **End-to-End Application Monitoring**
 
-Click on the gear icon next to the Room's name in the top of the page to do that. This will open the Rooms settings view, where you can take the same actions as with the Spaces settings, but now catered towards the specific Room.
+   Create Rooms for:
+    - Complete SaaS product stacks.
+    - Internal service dependencies.
+    - Full application ecosystems including Kubernetes clusters, Docker containers, Proxies, Databases, Web servers, and Message brokers.
 
-## Invite your team
+3. **Incident Response**
 
-Invite your entire SRE, DevOPs, or ITOps team to your Space, to give everyone access into your infrastructure from a single pane of glass.
+   Create dedicated Rooms for:
+    - Active incident investigation.
+    - Problem diagnosis.
+    - Performance troubleshooting.
+    - Root cause analysis.
 
-To do so, click on **Invite Users** in the [Space](#netdata-cloud-spaces) management area or any other such prompt around the UI.
+### Room Management
 
-Follow the instructions on screen, to provide the right access and role to the users you want to invite.
+**Navigation**
+
+1. Access Rooms through the Space's sidebar.
+2. Click the green plus (**+**) icon next to "Rooms" to create new Rooms.
+
+   <img src="https://github.com/user-attachments/assets/16958ba8-53ac-4e78-a51f-7ea328e97f31" height="400px" alt="Individual Space sidebar">
+
+**Settings and Configuration**
+
+1. Click the gear icon next to the Room name.
+2. Manage:
+    - Room access.
+    - Node grouping.
+    - Dashboard settings.
+    - Monitoring configurations.
+
+## Team Collaboration
+
+**Inviting Team Members**
+
+1. Click "Invite Users" in the Space's sidebar.
+2. Set appropriate access levels:
+    - Rooms.
+    - User roles.
+
+**Best Practices for Team Access**
+
+- Invite all relevant team members (SRE, DevOps, ITOps).
+- Configure role-based access control.
+- Maintain clear permission hierarchies.
+- Regular access review and updates.

packaging/installer/README.md

@@ -7,7 +7,7 @@ Netdata is very flexible and can be used to monitor all kinds of infrastructure.
 The easiest way to install Netdata on your system is via Netdata Cloud, to do so:
 
 1. Sign in to <https://app.netdata.cloud/>.
-2. Select a [Space](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#netdata-cloud-spaces), and click the "Connect Nodes" prompt, which will show the install command for your platform of choice.
+2. Select a [Space](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#spaces), and click the "Connect Nodes" prompt, which will show the install command for your platform of choice.
 3. Copy and paste the script into your node's terminal, and run it.
 
 Once Netdata is installed, you can see the node live in your Netdata Space and charts in the [Metrics tab](/docs/dashboards-and-charts/metrics-tab-and-single-node-tabs.md).

packaging/installer/methods/macos.md

@@ -31,8 +31,7 @@ The Netdata Agent is installed under `/usr/local/netdata`. Dependencies are hand
 
 The `kickstart.sh` script accepts additional parameters to automatically [connect](/src/claim/README.md) your node to Netdata
 Cloud immediately after installation. Find the `token` and `rooms` strings by [signing in to Netdata
-Cloud](https://app.netdata.cloud/sign-in?cloudRoute=/spaces), then clicking on **Connect Nodes** in the [Spaces management
-area](/docs/netdata-cloud/organize-your-infrastructure-invite-your-team.md#netdata-cloud-spaces).
+Cloud](https://app.netdata.cloud/sign-in?cloudRoute=/spaces), then clicking on **Connect Nodes** on any of the prompts from the UI.
 
 - `--claim-token`: Specify a unique claiming token associated with your Space in Netdata Cloud to be used to connect to the node
   after the install.