Merge pull request #1255 from Macrometacorp/cloud-workspaces

Cloud workspaces

docs/workspaces/index.md

@@ -11,9 +11,7 @@ title: Cloud Workspaces
 
 # Macrometa Cloud Workspaces
 
-Macrometa Cloud Workspaces redefines the digital workplace by delivering secure, high-performance virtual work environments that users can access from any internet-connected device on a browser. By harnessing the power of CDN edge computing, Cloud Workspaces ensures minimal latency, creating a responsive and ideal experience that empowers teams to work efficiently, no matter where they are.
-
-## Start using Cloud Workspaces
+Macrometa Cloud Workspaces redefines the digital workplace by delivering secure, high-performance virtual work environments that users can access from any internet-connected device on a browser. By harnessing the power of CDN edge computing, Cloud Workspaces ensures minimal latency, creating a more responsive and ideal experience that empowers teams to work efficiently, no matter where they are.
 
 <grid cols={3}>
  <card
@@ -22,26 +20,26 @@ Macrometa Cloud Workspaces redefines the digital workplace by delivering secure,
     href="/quickstart"
   />
    <card
-    heading="Peripherals Validator"
-    description="Validate your peripheral devices for a better Cloud Workspaces experience"
-    href="/workspaces/peripheral-validator"
+    heading="Remote Browser Accelerator"
+    description="Access your web apps at the edge for better performance"
+    href="/workspaces/remote-browser-accelerator"
   />
    <card
     heading="Remote Desktop Environments"
-    description="Access a remote desktop environment for your daily tasks"
+    description="Access Windows and Linux remote desktops for your work tasks"
     href="/workspaces/remote-desktop-enviroment"
   />
  </grid>
 
-## Cloud Workspaces Toolbox
+## Cloud Workspaces toolbox
 
 At its core, Cloud Workspaces integrates the following advanced technologies:
 
-- **[Remote Browser Acceleration (RBA)](./remote-browser-accelerator/index.md)**: RBI offers a powerful approach to web security by executing all web browsing activities within isolated cloud environments. This isolation ensures that any potential threats from web content are contained and kept away from the user's local device, significantly reducing the risk of malware and other web-based attacks.
-- **Remote Browser Isolation (RBI)**: RBA enhances the performance of specific web applications by deploying them directly at the network edge. It extends the remote browser isolation by allowing users to interact with web apps as if they were running locally on their devices, ensuring optimal speed and responsiveness. By accelerating the delivery of these applications, RBA guarantees
-- **[Remote Desktop Environments (RDE)](./remote-desktop-enviroment/index.md)**: RDE provides full-featured Windows and Linux remote desktop environments, accessible from any device with an internet connection. These desktops are hosted in the cloud, allowing users to access their familiar workspace, including all applications and data, from anywhere. VDI ensures consistency and flexibility, enabling users to maintain productivity regardless of their location.
+- **[Remote Browser Acceleration (RBA)](./remote-browser-accelerator/index.md)**: RBA enhances the performance of specific web applications by deploying them directly at the network edge. It extends remote browser isolation by allowing users to interact with web apps as if running locally on their devices, ensuring optimal speed and responsiveness. By accelerating the delivery of these applications, RBA guarantees a better user experience and improved work efficiency. 
+- **Remote Browser Isolation (RBI)**: RBI offers a powerful approach to web security by executing all web browsing activities within isolated cloud environments. This isolation ensures that any potential threats from web content are contained and kept away from the user's local device, significantly reducing the risk of malware and other web-based attacks.
+- **[Remote Desktop Environments (RDE)](./remote-desktop-enviroment/index.md)**: RDE provides full-featured Windows and Linux remote desktop environments accessible from any device with an internet connection. These desktops are hosted in the cloud, allowing users to access their familiar workspace from anywhere, including all applications and data. VDI ensures consistency and flexibility, enabling users to maintain productivity regardless of location.
 
-These technologies work together to deliver a versatile and secure workspace solution on the edge, tailored to the diverse needs of modern businesses. It enables rapid deployment of web applications, secure and isolated browsing sessions, and full-featured virtual desktops—all within a unified environment designed to enhance productivity and maintain strong security.
+These technologies work together to deliver a versatile and secure workspace solution on the edge, tailored to the diverse needs of modern businesses. It enables rapid deployment of web applications, secure and isolated browsing sessions, and full-featured virtual desktops— all within a unified environment designed to enhance productivity and maintain strong security.
 
 ## Key benefits
 

docs/workspaces/quickstart.md

@@ -3,11 +3,11 @@ title: Quickstart
 sidebar_position: 1
 ---
 
-Cloud Workspaces is deployed and managed by Macrometa's engineering team based on your product needs, ensuring optimal performance and security. 
+Cloud Workspaces is deployed and managed by Macrometa's engineering team based on your product needs, ensuring optimal performance and security. This short guide walks you through getting started with the service. 
 
 ## Prerequisites
 
-Ensure to have the following installed before using Cloud Workspaces:
+Before you can start using Workspaces, ensure to have the following installed:
 
 1. For **Windows 10**, download the latest stable **Chrome** browser.
 
@@ -30,15 +30,24 @@ Ensure to have the following installed before using Cloud Workspaces:
 Once your browser is installed on your device,
 
 1. Contact Macrometa support to receive your unique URL for accessing your Cloud Workspace environment.
-1. Open your local browser and enter the provided URL in the address bar. This URL connects you to your remote workspace.
+1. Open your local browser and enter the provided URL in the address bar. Enter your login details.
 
-Once connected, you'll see the specific web applications deployed for your business use case under Workspaces, along with the virtual Linux and Windows desktops. Additionally you have VS Code, a remote IDE for developers. Refer to the [RBA](./remote-browser-accelerator/index.md) and [RDE](./remote-desktop-enviroment/index.md) documentation for more details on how to use these workspaces.
+    ![login-screen](/img/workspaces/login-screen.png)
+
+- After login, first-time users are taken to the onboarding screen. The onboarding screen contains different installers for using Cloud Workspaces tools. Download the appropriate installer based on your specific requirements and refer to the respective guides for detailed instructions on how to set up the [VDI](./remote-desktop-enviroment/index.md) and [RBA](./remote-browser-accelerator/getting-started.md) installers.
+
+    ![onboarding-screen](/img/workspaces/onboarding-screen.png)
+
+- Returning users are redirected to the homepage.
+
+    ![Cloud Workspace interface](/img/workspaces/homepage.jpeg)
+
+The Workspaces homepage displays the different tools available in the service, and allows you to navigate between these tools.
 
-![Cloud Workspace interface](/img/workspaces/workpsace-screen.png)
 
 ## Validating Peripheral Devices
 
-Workspaces offers its [Peripheral Validator](./peripheral-validator.md), a feature that allows your peripheral devices connect to it successfully to ensure a smooth and productive experience. This feature enhances the user experience by allowing the use of essential hardware in virtual environments. Cloud Workspaces currently supports the following peripheral devices:
+Workspaces offers its [Peripheral Validator](./remote-browser-accelerator/rba-peripheral-validator.md), a feature that allows your peripheral devices connect to it successfully to ensure a smooth and productive experience. This feature enhances the user experience by allowing the use of essential hardware in virtual environments. Cloud Workspaces currently supports the following peripheral devices:
 
 - Signature pad
 - Card reader

docs/workspaces/remote-browser-accelerator/getting-started.md

@@ -0,0 +1,38 @@
+---
+title: Getting started
+---
+
+RBA allows you access your work applications and tools at the edge, thus reducing latency and improving performance. This guide walks you through the necessary steps to using the service. 
+
+At the end of this guide, you will be able to:
+
+- Download and install the RBA installer
+- Get RBA started and launch your necessary work applications.
+- Use the RBA control bar for a better experience
+
+## Prerequisites
+
+Before proceeding, ensure to do the following:
+
+- Get your Workspace URL and login details from Macrometa support.
+- [Download the RBA installer](#step-1-download-and-install-the-rba-installer)
+
+## Step 1: Download and Install the RBA Installer
+
+The RBA installer is a driver that enables you to launch your applications with the service. To install this driver:
+
+1. Launch your provided Workspace URL in your preferred browser to access the Workspaces homepage.
+1. Follow one of these steps based on your usage level:
+    - For first-time users, you are directed to an onboarding screen that displays various installers for different needs. Click **Download RBA Installer**
+    - For returning users, click **Download Package** from the bottom of the left-side menu on the homepage. This takes you to the onboarding page with the various installers. Click **Download RBA Installer**.
+
+    ![onboarding-screen](/img/workspaces/onboarding-screen.png)
+1. Run the installer and enter your **Email** and **RBA Installer Token**. You can find and copy the RBA Installer Token from the onboarding screen.
+
+## Step 2: Launch your web apps
+
+With the installer now successfully installed:
+
+1. Navigate to the Workspaces homepage
+1. Click on the web app you wish to use. By default, the selected application or service will open in a tab within the remote browser. A control bar icon `>` appears on the left side of the screen, allowing you to easily manage and interact with the remote browser.
+

docs/workspaces/remote-browser-accelerator/index.md

@@ -5,61 +5,4 @@ title: Remote Browser Acceleration (RBA)
 
 Remote Browser Acceleration (RBA) enhances the performance of specific web applications by deploying them directly at the network edge. This allows users to interact with web apps remotely as if they were running locally on their devices, ensuring optimal speed and responsiveness. By offloading processing tasks to a remote browser, RBA ensures faster page load times, improved responsiveness, and consistent performance, even on legacy or resource-constrained systems.
 
-## Getting started with RBA
-
-To begin using Remote Browser Acceleration (RBA) with Cloud Workspaces, follow these steps:
-
-1. Confirm you have completed the initial setup for Cloud Workspaces and have obtained your unique workspace URL from Macrometa support.
-
-2. Launch the provided workspace URL in your browser. This action will display the web applications deployed for your specific business needs, along with virtual Linux and Windows desktops. Additionally you have VS Code, a remote IDE for developers.
-
-![Workspaces Menu](/img/workspaces/workpsace-screen.png)
-
-3. From the displayed options, select the web app you wish to use. By default, the selected application or service will open in a tab within the remote browser. A control bar icon ![Control Bar Icon](/img/workspaces/control-bar-icon.png) appears on the left side of the screen, allowing you to easily manage and interact with the remote browser.
-
-### Using the RBA control bar
-
-The Remote Browser Acceleration (RBA) control bar provides a comprehensive interface for managing and optimizing your remote browsing experience. It includes options to toggle fullscreen mode, manage keyboard inputs, and access the clipboard. Additionally, users can configure display settings and customize various other settings to tailor the remote browser environment to their specific needs.
-
-To access the RBA control bar,
-
-- Click the control bar icon ![Control Bar Icon](/img/workspaces/control-bar-icon.png) on the left side of the browser to access the menu.
-
-![RBA Control Bar](/img/workspaces/control-bar.png)
-
-Below is an overview of each menu on the control bar and how to use them to enhance your browsing experience.
-
-1. **Drag viewport**: This setting allows you to move the remote browser window around the screen when minimized.
-
-2. **Keys**: The keys menu provides on-screen buttons for essential control keys such as **Control**, **Alt**, **Tab**, and the **Esc** key. This functionality is especially handy for mobile device users who don't have access to a full keyboard.
-
-3. **Clipboard**: The clipboard feature allows text transfer between your local device and the remote browser. Text copied within the remote browser appears in this panel for easy access. This is not compulsory for the Chrome browser, as it has native clipboard integration that handles text efficiently.
-
-4. **Fullscreen**: Full screen maximizes the remote browser to fill your entire screen, providing an immersive and distraction-free browsing experience. Use the **Esc** key to exit fullscreen mode.
-
-5. **USB**: The USB menu displays all devices connected to your local device via USB. To connect a device to the remote browser, select it from the list and click **Connect**.
-
-6. **Display:** This menu allows you to manage multiple monitors efficiently. Click the **Display** menu to add, remove, and arrange screens. New screens open in separate browser windows, which you can position on your local monitors. Use the Display menu to match the on-screen arrangement to your physical setup and adjust positions and sizes as needed.
-
-   ![Display Menu](/img/workspaces/display-menu.png)
-7. **Settings:** The Settings menu lets you customize your remote browser further. Here, you can adjust various aspects to tailor the browser to your preferences and optimize your user experience.
-
-   ![Settings Menu](/img/workspaces/rba-settings.png)
-
-   a. **View-only**: This option restricts the remote browser to a read-only mode, preventing any write operations. Users can browse and view content without being able to modify or interact with elements.
-
-   b. **Clipboard Up**: Allows users to copy text from their local device and paste it into the remote browser.
-
-   c. **Clipboard Down**: Enables copying content from the remote browser and pasting it onto your local device.
-
-   d. **Clipboard Seamless**: This feature facilitates copying and pasting between your local device and the remote browser without noticeable delays or additional steps.
-
-   e. **Prefer Local Cursor**: Prioritizes using the local machine's cursor for display and interaction, providing a more consistent user experience.
-
-   f. **Translate keyboard shortcuts**: Automatically converts local keyboard shortcuts to the corresponding shortcuts in the remote browser, ensuring they function correctly within the remote environment.
-
-   g. **Enable Performance Stats**: This option displays real-time performance metrics of the remote browser at the top right corner of the screen. These metrics include an FPS counter, along with network and CPU stats, where each stat shows the current value and an averaged value over time. A lower value indicates higher resource constraints, helping to identify if performance bottlenecks are due to server-side CPU or network issues.
-
-   h. **Enable Pointer Lock:** Constrains the cursor within the remote browser window, providing better control during use. To release the cursor, press the escape key.
-
-8. **Audio:** Click the audio icon ![Audio Icon](/img/workspaces/audio-icon.png) to enable or disable audio output from the remote browser.
+You can [start using RBA by downloading the installer](getting-started.md#step-1-download-and-install-the-rba-installer)