Reorganize and Update Cloud FAQ (#171)

* refactor-cloud-faq

* Cloud FAQ: update Virtual Users question

* Cloud FAQ: Data Retention

* Data retention Redirect

* Debuggin in the Cloud

* Cloud FAQ: IPs and Firewall

* Cloud FAQ: Test status codes

* Cloud FAQ: I was invited to an org

* General Questions Page

* Fix redirects

* Dedicated IP question and sidebar content

* Add separator to Cloud FAQ questions

Author: Pepe Cano

gatsby-node.js

@@ -554,10 +554,73 @@ const createRedirects = ({ actions, pathPrefix }) => {
   });
 
   createRedirect({
-    fromPath: '/docs/cloud/creating-and-running-a-test/converters',
+    fromPath: '/cloud/creating-and-running-a-test/converters',
     toPath: '/integrations',
     isPermanent: true,
   });
+
+  createRedirect({
+    fromPath: '/cloud/integrations/ci',
+    toPath: '/integrations',
+    isPermanent: true,
+  });
+
+  createRedirect({
+    fromPath: '/cloud/cloud-faq/calculating-virtual-uses-with-google-analytics',
+    toPath: 'https://k6.io/blog/monthly-visits-concurrent-users',
+    isPermanent: true,
+  });
+
+  createRedirect({
+    fromPath: '/cloud/cloud-faq/what-is-data-retention',
+    toPath: '/cloud/billing-user-menu/data-retention',
+    isPermanent: true,
+  });
+
+  createRedirect({
+    fromPath: '/cloud/cloud-faq/pricing-faq',
+    toPath: '/cloud/cloud-faq/pricing-questions',
+    isPermanent: true,
+  });
+
+  createRedirect({
+    fromPath: '/cloud/cloud-faq/what-ip-addresses-are-used-by-the-k6-cloud',
+    toPath: '/cloud/cloud-faq/general-questions',
+    isPermanent: true,
+  });
+  createRedirect({
+    fromPath:
+      '/cloud/cloud-faq/what-is-the-best-way-to-debug-my-load-test-scripts',
+    toPath: '/cloud/cloud-faq/general-questions',
+    isPermanent: true,
+  });
+  createRedirect({
+    fromPath:
+      '/cloud/cloud-faq/i-was-invited-to-an-organization-and-i-cannot-run-tests',
+    toPath: '/cloud/cloud-faq/general-questions',
+    isPermanent: true,
+  });
+  createRedirect({
+    fromPath:
+      '/cloud/cloud-faq/how-to-open-your-firewall-to-k6-cloud-service-for-cloud-executed-tests',
+    toPath: '/cloud/cloud-faq/general-questions',
+    isPermanent: true,
+  });
+  createRedirect({
+    fromPath: '/cloud/cloud-faq/test-status-codes',
+    toPath: '/cloud/cloud-faq/general-questions',
+    isPermanent: true,
+  });
+  createRedirect({
+    fromPath: '/cloud/cloud-faq/what-are-vus-virtual-users',
+    toPath: '/cloud/cloud-faq/general-questions',
+    isPermanent: true,
+  });
+  createRedirect({
+    fromPath: '/cloud/cloud-faq/data-uploads-with-k6-cloud',
+    toPath: '/cloud/cloud-faq/general-questions',
+    isPermanent: true,
+  });
 };
 
 exports.createPages = async (options) => {

src/data/markdown/docs/01 guides/04 Results visualization/02 Cloud.md

@@ -3,9 +3,9 @@ title: 'Cloud'
 excerpt: ''
 ---
 
-Besides [running cloud tests](/cloud/creating-and-running-a-test/cloud-tests-from-the-cli), you can also stream your test results in real-time to the [k6 Cloud](/cloud).
+Besides [running cloud tests](/cloud/creating-and-running-a-test/cloud-tests-from-the-cli), you can also run a test locally and stream the results to the [k6 Cloud](/cloud).
 
-The k6 Cloud will pre-process your data, and you can visualize and analyze the results on the web app.
+When streaming the results to the k6 Cloud, the machine - where you execute the k6 CLI command - runs the test and uploads the results to the k6 Cloud. Then, you will be able to visualize and analyze the results on the web app in real-time.
 
 ## Instructions
 
@@ -61,8 +61,15 @@ execution: local
 
 ![k6 Cloud Test Results](./images/Cloud/k6-cloud-results.png)
 
+> When you send the results to the k6 Cloud, data will be continuously streamed to the cloud. While this happens the state of the test run will be marked as `Running`. A test run that ran its course will be marked `Finished`. The run state has nothing to do with the test passing any thresholds, only that the test itself is operating correctly.
+> 
+> If you deliberately abort your test (e.g. by pressing _Ctrl-C_), it will still be considered `Finished`. You can still look and analyze the test data you streamed so far. The test will just have run shorter than originally planned.
+> 
+> Another possibility would be if you lose network connection with the k6 Cloud while your test is running. In that case the k6 Cloud will patiently wait for you to reconnect. In the meanwhile your test's run state will continue to appear as `Running` on the web app.
+> 
+> If no reconnection happens, the k6 Cloud will time out after two minutes of no data, setting the run state to `Timed out`. You can still analyze a timed out test but you'll of course only have access to as much data as was streamed before the network issue.
+
 ## See also
 
 - [Analyzing results on the k6 Cloud](/cloud/analyzing-results/overview)
 - [Running cloud tests](/cloud/creating-and-running-a-test/cloud-tests-from-the-cli)
-- [Cloud test run status - Uploading results](/cloud/cloud-faq/test-status-codes#uploading-results)

src/data/markdown/docs/01 guides/07 Misc/06 Glossary.md

@@ -170,6 +170,20 @@ A **test script** is the actual code you run as part of your test run, as well a
 
 Virtual Users, although emulated by k6 itself, can be used to mimic the behavior of a real user.
 
-VUs typically perform requests at a much higher rate than regular users. Because of this, there is seldom any need for anywhere near as many virtual users as the actual user target.
+**Virtual Users in context of Web Apps/Websites**
 
-For additional details, see [What are virtual users?](/cloud/cloud-faq/what-are-vus-virtual-users).
+Virtual Users are designed to act and behave like real users/browsers would. That is, they are capable of making multiple network connections in parallel, just like a real user in a browser would. When using a [http.batch](/using-k6/options#batch) request, HTTP requests are sent in parallel. For further information, refer to the article about [load testing websites](/testing-guides/load-testing-websites).
+
+<CodeGroup labels={["Formula for calculating the number of VUs needed"]}>
+
+```plain
+VUs = (hourly sessions * average session duration in seconds)/3600
+```
+
+</CodeGroup>
+
+Read more about using this formula in the [tutorial to calculate the number of Virtual Users with Google Analytics](https://k6.io/blog/monthly-visits-concurrent-users).
+
+**Virtual Users in context of APIs**
+
+When testing individual API endpoints, you can take advantage of each VU making multiple requests each to produce requests per second(rps) a factor higher than your VU count. e.g. Your test may be stable with each VU making 10 rps each. If you wanted to reach 1000 RPS, you may only need 100 VUs in that case. For more information on testing APIs, please refer to our article [API Load Testing](/testing-guides/api-load-testing).

src/data/markdown/docs/03 cloud/05 Billing & User Menu/02 Subscription.md

@@ -23,4 +23,4 @@ To downgrade your subscription, you may select a new plan at any time. We will b
 
 ## Cancelation / Data Retention
 
-You may cancel your online subscription at any time through the web app. When canceling you are able to opt into Data Retention to save your result data longer term / between projects. If you do not choose data retention all test result data is deleted 7 days after your subscription expires. When canceling you may use your plan through the end of the current period.
+You may cancel your online subscription at any time through the web app. When canceling you are able to opt into [Data Retention](/cloud/billing-user-menu/data-retention) to save your result data longer term / between projects. If you do not choose data retention all test result data is deleted 7 days after your subscription expires. When canceling you may use your plan through the end of the current period.

src/data/markdown/docs/03 cloud/05 Billing & User Menu/04 Data Retention.md

@@ -0,0 +1,41 @@
+---
+title: 'Data Retention'
+excerpt: 'What is k6 data retention and how does it work?'
+---
+
+Data retention refers to the policy that specifies how long the k6 Cloud service will keep your test result data.
+
+k6 differentiates between test result data and your user data (projects, profiles, etc.). In terms of data retention, we are referring only to test result data. Your **user data and test configurations are saved indefinitely** on your user profile.
+
+<Blockquote mod="warning">
+
+Data is retained on a rolling basis. **Test result data older than what is specified in your plan is automatically deleted**. If you need to save data, please be sure to export, set the test as baseline, or purchase a period of data retention that meets your requirements.
+
+</Blockquote>
+
+## How long is my data retained
+
+Data is retained on a rolling basis, depending on your subscription. For plans with 1 month of data retention, we will retain data for 30 days from the test run. After that period the data is deleted. This rolling period only applies while you have an active subscription. If you cancel your subscription, data is retained for 7 days past subscription expiration.
+
+
+## How do I save my baseline test result
+
+**Baseline test results** are exempt from data retention rules and are **saved indefinitely.**
+
+You can select a single test run per test as a baseline test. The purpose of this is to serve as a point of comparison for future tests. To mark a test as baseline, use the three dot menu in the top right corner of your test run and click `Set as Baseline`.
+
+![Set as baseline](images/04-data-retention/set-as-baseline.png)
+
+## Can I export my data
+
+Yes, you can export your test results. Read more [here](/cloud/analyzing-results/result-export).
+
+## When can I purchase Data Retention
+
+Every subscription plan automatically includes a period of data retention that specifies how long the k6 Cloud retains your test results. For more info about each plan's data retention policy, read [How long is my data retained](#how-long-is-my-data-retained) and visit the [pricing page](https://k6.io/pricing/). 
+
+If you need a data retention policy longer than specified in our plans, please reach out to support for pricing information.
+
+## Buying a Data Retention plan after cancelation
+
+When canceling your subscription, you are able to buy a Data Retention plan. This plan allows you to retain your result data at a lower rate between testing periods.