diff --git a/src/data/markdown/docs/01 guides/03 Test authoring/01 test builder.md b/src/data/markdown/docs/01 guides/03 Test authoring/01 test builder.md
new file mode 100644
index 0000000000..a49ea17673
--- /dev/null
+++ b/src/data/markdown/docs/01 guides/03 Test authoring/01 test builder.md
@@ -0,0 +1,69 @@
+---
+title: 'Test builder'
+excerpt: ''
+---
+
+The k6 Test Builder allows you to utilize a graphical interface to create a k6 test.
+
+Based on your input, the test builder will automatically generate the k6 script for you. Once done, you can copy the script and [run the test from the CLI](/getting-started/running-k6).
+
+> **Note**: you need a [k6 Cloud](/cloud) account to use the test builder. However, it is **free to use**, and you do not need an active subscription to utilize this feature.
+
+Although we strongly believe that scriptable/code-based tools will help you get the most out of your performance testing efforts, a GUI-based tool like the test builder could benefit you in:
+
+- Speeding up the test creation.
+- Learning the [k6 API](/javascript-api).
+- Streamlining the collaboration building tests with non-coders.
+
+
+
+## Instructions
+
+1 - [Login](https://app.k6.io/account/login) into the k6 Cloud.
+
+2 - On the sidebar menu, click the [Create New Test](https://app.k6.io/tests/new) button.
+
+3 - Select `Test builder`.
+
+
+
+4 - Now, you can start building your k6 test using the graphical interface.
+
+
+
+
+## Test builder features
+
+We are continuously improving and adding new capabilities to the test builder. A few of the most prominent features are:
+
+**Test configuration**
+
+- Configure ramping (aka [stages](/using-k6/options#stages)) using VUs and duration.
+- Configure [load zones](/cloud/creating-and-running-a-test/cloud-tests-from-the-cli#list-of-supported-load-zones) to run from the k6 Cloud.
+
+**HTTP Requests**
+
+- Add a request and name it for better description.
+- Change the URL/Endpoint.
+- Change the `HTTP METHOD` using the drop down menu.
+- Specify Headers.
+- Specify Query Parameters.
+- Specify a request body (JSON, Text, or File Content) for POST/PUT/PATCH requests.
+- Reorganize requests by clicking and dragging.
+- Duplicate or delete requests when hovering over a specific request.
+
+**k6 API**
+
+- Define the [thresholds](/using-k6/thresholds) of your test.
+- Add a [check](/javascript-api/k6/check-val-sets-tags) on a request response.
+- Add [sleep](/javascript-api/k6/sleep-t) time between requests.
+- Add a [group](/javascript-api/k6/group-name-fn) to the test.
+
+**And more**
+
+- Populate the test builder with the recorded requests using the [browser recorder](/test-authoring/recording-a-session/browser-recorder).
+- Populate the test builder with the requests included in a [HAR file](https://en.wikipedia.org/wiki/HAR_(file_format)).
+- Capture a variable when dealing with dynamic data, such as authentication tokens.
+- Show examples for better onboarding.
+- Toggle the view mode to see or copy the generated k6 script.
+- Run the test on the k6 Cloud.
diff --git a/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session.md b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session.md
new file mode 100644
index 0000000000..b8a279fc4f
--- /dev/null
+++ b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session.md
@@ -0,0 +1,19 @@
+---
+title: 'Recording a session'
+excerpt: ''
+---
+
+In load testing, _recording_ usually refers to the process of creating a load test from the recording of a user session. The process consists of three steps:
+
+1. Record a user or API session.
+2. Convert the recorded session into a test.
+3. Run the test.
+
+While not exclusive, it is common to use recordings while testing complex scenarios on websites or mobile applications. Recording allows seeing the sequence of requests and parameters of the session, helping testers quickly build out complex chains of requests.
+
+Suppose you have to create a performance test simulating a user journey with dozens or hundreds of requests. In that case, the recording avoids writing it from scratch.
+
+k6 provides two mechanism to generate a k6 script from a recorded user session:
+
+- [Browser recorder](/test-authoring/recording-a-session/browser-recorder) generates a k6 script from a browser session. Available on [Chrome](https://chrome.google.com/webstore/detail/k6-browser-recorder/phjdhndljphphehjpgbmpocddnnmdbda?hl=en) and [Firefox](https://addons.mozilla.org/en-US/firefox/addon/k6-browser-recorder/).
+- [HAR converter](/test-authoring/recording-a-session/har-converter) generates a k6 script from the requests included in a HAR file.
diff --git a/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/01 Browser recorder.md b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/01 Browser recorder.md
new file mode 100644
index 0000000000..177e608fab
--- /dev/null
+++ b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/01 Browser recorder.md
@@ -0,0 +1,86 @@
+---
+title: 'Browser recorder'
+excerpt: ''
+---
+
+
+The browser recorder allows generating a k6 script based on a web session. It is available as extensions for [Chrome](https://chrome.google.com/webstore/detail/k6-browser-recorder/phjdhndljphphehjpgbmpocddnnmdbda?hl=en) and [Firefox](https://addons.mozilla.org/en-US/firefox/addon/k6-browser-recorder/).
+
+### k6 Cloud integration
+
+The browser recorder functionality is powered by the [k6 Cloud](/cloud). When the user finalizes the recording of the session, the extension will upload the auto-generated k6 test into the k6 Cloud account.
+
+> **Note**: the recorder is **free to use** and you do not need an active k6 Cloud subscription to utilize it.
+>
+> Any user can copy the script from the [script editor](/cloud/creating-and-running-a-test/script-editor) to edit or run the test locally using the `k6 run` command. In the future, we plan to make this feature operational without having a k6 Cloud account.
+
+
+### How it works
+
+The browser recorder allows you to generate the bulk of your test scripts simply by browsing like a user would on your site or web app. The script created gives you a foundation which you can further edit, as required.
+
+The recorder will capture everything – every single HTTP(s) request being loaded into the browser as you click – including ads, images, documents, etc., so you get a far more accurate read of what’s going on. Just press “record”, start browsing and when complete, the script will automatically get saved to your k6 Cloud account.
+
+
+## Instructions
+
+1 - **Install** the [Chrome](https://chrome.google.com/webstore/detail/k6-browser-recorder/phjdhndljphphehjpgbmpocddnnmdbda?hl=en) or [Firefox](https://addons.mozilla.org/en-US/firefox/addon/k6-browser-recorder/) extension.
+
+2 - **Start a recording**
+
+Open the extension by clicking the k6 logo, and press "Start recording" to begin recording the current browser tab. It's good to have in consideration the following best practices to record a user session:
+
+**Do**
+
+- Browse like a user would
+- Take natural pauses that users would take to consume page content
+- Focus on the most common use cases, rather than all the possible use cases
+- Take note of pages where forms/logins occur, you will likely need to do some additional scripting here to make it use dynamic values.
+
+**Do not**
+
+- Visit every page in one journey
+- Click every possible option
+- Navigate as fast as you can
+- Navigate away your actual site or application
+
+
+
+3 - **Stop the recording**
+
+When done, press "Stop recording", you'll be taken to the app to review the recorded test script
+
+
+
+4 - **Save your test script**
+
+Save the recorded script in any of your projects.
+
+If any **third party requests** are made during the recording, those requests will be filtered out by default because:
+
+- These third-party requests will skew the percentiles of your performance results.
+- You may not have the ability to impact the performance of third-party services
+- The load test may violate the terms of service contract that you have with the provider.
+
+If you want to include some of the requests in the _third party list_, simply deselect the ones you want to include, then hit save.
+
+
+
+5 - **Edit your script** as necessary.
+
+Depending on the type of testing, you might need to change different aspects of the script. The most usual changes are:
+- Changing the [load options](/using-k6/options). The default is a 12 min ramp-up test.
+- Handling [correlation and dynamic data](/examples/correlation-and-dynamic-data).
+
+> #### Things to consider
+>
+> - The auto-generated script sets [discardResponseBodies](/using-k6/options#discard-response-bodies) to `true`. This configuration will discard all response bodies.
+> - The browser extension will not record other tabs or pop up windows. If you need to capture this information, you should try the [HAR converter](/test-authoring/recording-a-session/har-converter).
+
+6 - **Run the test** locally or in the k6 Cloud.
+
+If you want to run a cloud test from the k6 Cloud UI, press `Run` to start the test.
+
+If you want to use the k6 CLI to run a local or cloud test, copy the generated script to your local text editor and execute the `k6 run` or `k6 cloud` command to start the test.
+
+For learning more about running k6, check out the [Running k6 guide](/getting-started/running-k6).
diff --git a/src/data/markdown/docs/01 guides/02 Using k6/13 Session recording - HAR support.md b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/02 Har converter.md
similarity index 75%
rename from src/data/markdown/docs/01 guides/02 Using k6/13 Session recording - HAR support.md
rename to src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/02 Har converter.md
index fd3f6f53a1..ba0c85ac40 100644
--- a/src/data/markdown/docs/01 guides/02 Using k6/13 Session recording - HAR support.md
+++ b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/02 Har converter.md
@@ -1,31 +1,22 @@
---
-title: 'Session recording / HAR support'
+title: 'HAR converter'
excerpt: ''
---
-In terms of load testing, recording usually refers to the process of creating a load test from the recording of a user session. The process looks like:
-1. Record a user or API session.
-2. Convert the recorded session into a test.
-3. Run the test.
+The HAR converter is an alternative to the [Browser recorder](/test-authoring/recording-a-session/browser-recorder). It generates a k6 script based on the HTTP requests included on a [HAR file]().
-While not exclusive, it is common to use the recording when testing complex scenarios of websites or mobile applications. If you have to create a performance test that simulates a scenario with dozens or hundreds of requests, the recording could help you to be more productive in creating your test.
+> HAR is a file format used by all major browsers and various other tools to export recorded HTTP requests.
-Recording allows seeing the sequence of requests and parameters of the session instead of having to figure them out. Additionally, you could use the recorded information to auto-generate your test instead of building it from scratch.
+The [har-to-k6 converter](https://github.com/loadimpact/har-to-k6) is a NodeJS tool. Unlike the Browser Recorder, it **does not require a k6 Cloud user** to generate the k6 script.
-k6 does not have built-in functionality to record user or API sessions, but it allows to auto-generate a k6 script via an [HAR file](); HAR is a file format used by all the browsers and various tools to export the recorded HTTP requests.
-
-In k6, the process looks like:
+When using the HAR converter, the process looks like:
1. Record a HAR file using your browser or tool of choice.
2. Use the **har-to-k6 converter** to generate a k6 test from the HAR file.
-3. Update the auto-generated k6 test.
+3. Update the auto-generated k6 test in your text editor or IDE.
4. Use **k6** to run the test.
-> The auto-generation of the test is a great option to add to your toolbox. It’s common practice for advanced user flows that generate many sophisticated HTTP requests, or for helping testers to identify the format of the requests.
->
-> The recording avoids writing advanced tests from scratch, saving you time building your performance tests.
-
## 1. Record a HAR file
Multiple browsers and tools can be used to export HTTP traffic in a HAR format. A few popular ones are:
@@ -46,7 +37,7 @@ Here are the basic steps you need to take to make a recording in Chrome:
6. Enter the URL of your site and start doing whatever you'd like your simulated load test users to be doing.
7. When done, right-click on the list of URLs in Chrome developer tools and choose "Save as HAR with content".
-
+
It's good to have in consideration the following best practices to record a user session:
@@ -141,13 +132,13 @@ In Chrome, you can use the DevTools Network Filter to select only particular dom
/loadimpact.com|cloudfront.net/
```
-
+
After filtering your selected domains, you can download the HAR file as described in the first step of this tutorial, and the HAR file will only include the requests to the selected domains.
If you don’t know all the domains to filter, it is beneficial to use the query language of the Network Filter. Just input `domain:` in the filter to see all the different domains recorded by the Network Panel.
-
+
### Correlate dynamic data
@@ -171,6 +162,6 @@ $ k6 run loadtest.js
For learning more about running k6, check out the [Running k6 guide](/getting-started/running-k6).
-## Recording in the k6 Cloud Service
+## See also
-If you are a user of the k6 Cloud Service, you can directly upload HAR files through the web UI or [use a Chrome extension](/cloud/creating-and-running-a-test/recording-a-test-script) to create a script while recording a browsing session.
+- [Browser recorder](/test-authoring/recording-a-session/browser-recorder): Chrome and Firefox extensions to generate a k6 script from a browser session.
diff --git a/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/Recording-a-test-script/step-2.png b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/Recording-a-test-script/step-2.png
new file mode 100644
index 0000000000..ba280d0eb9
Binary files /dev/null and b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/Recording-a-test-script/step-2.png differ
diff --git a/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/Recording-a-test-script/step-3.png b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/Recording-a-test-script/step-3.png
new file mode 100644
index 0000000000..270bd41c59
Binary files /dev/null and b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/Recording-a-test-script/step-3.png differ
diff --git a/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/Recording-a-test-script/step-4.png b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/Recording-a-test-script/step-4.png
new file mode 100644
index 0000000000..dec2dd5f95
Binary files /dev/null and b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/Recording-a-test-script/step-4.png differ
diff --git a/src/data/markdown/docs/01 guides/02 Using k6/images/Session-recording-HAR-support/session_recorder_filter_domain.png b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/session_recorder_filter_domain.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/02 Using k6/images/Session-recording-HAR-support/session_recorder_filter_domain.png
rename to src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/session_recorder_filter_domain.png
diff --git a/src/data/markdown/docs/01 guides/02 Using k6/images/Session-recording-HAR-support/session_recorder_filter_domain_list.png b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/session_recorder_filter_domain_list.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/02 Using k6/images/Session-recording-HAR-support/session_recorder_filter_domain_list.png
rename to src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/session_recorder_filter_domain_list.png
diff --git a/src/data/markdown/docs/01 guides/02 Using k6/images/Session-recording-HAR-support/session_recorder_save_as_har.png b/src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/session_recorder_save_as_har.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/02 Using k6/images/Session-recording-HAR-support/session_recorder_save_as_har.png
rename to src/data/markdown/docs/01 guides/03 Test authoring/02 Recording a session/images/session_recorder_save_as_har.png
diff --git a/src/data/markdown/docs/01 guides/03 Test authoring/images/k6-create-new-test.png b/src/data/markdown/docs/01 guides/03 Test authoring/images/k6-create-new-test.png
new file mode 100644
index 0000000000..75560497bd
Binary files /dev/null and b/src/data/markdown/docs/01 guides/03 Test authoring/images/k6-create-new-test.png differ
diff --git a/src/data/markdown/docs/01 guides/03 Test authoring/images/test-builder.png b/src/data/markdown/docs/01 guides/03 Test authoring/images/test-builder.png
new file mode 100644
index 0000000000..e25e4bfae4
Binary files /dev/null and b/src/data/markdown/docs/01 guides/03 Test authoring/images/test-builder.png differ
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/01 Amazon CloudWatch.md b/src/data/markdown/docs/01 guides/04 Results visualization/01 Amazon CloudWatch.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/01 Amazon CloudWatch.md
rename to src/data/markdown/docs/01 guides/04 Results visualization/01 Amazon CloudWatch.md
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/01 Apache Kafka.md b/src/data/markdown/docs/01 guides/04 Results visualization/01 Apache Kafka.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/01 Apache Kafka.md
rename to src/data/markdown/docs/01 guides/04 Results visualization/01 Apache Kafka.md
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/02 Cloud.md b/src/data/markdown/docs/01 guides/04 Results visualization/02 Cloud.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/02 Cloud.md
rename to src/data/markdown/docs/01 guides/04 Results visualization/02 Cloud.md
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/03 CSV.md b/src/data/markdown/docs/01 guides/04 Results visualization/03 CSV.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/03 CSV.md
rename to src/data/markdown/docs/01 guides/04 Results visualization/03 CSV.md
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/04 DataDog.md b/src/data/markdown/docs/01 guides/04 Results visualization/04 DataDog.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/04 DataDog.md
rename to src/data/markdown/docs/01 guides/04 Results visualization/04 DataDog.md
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/05 InfluxDB - Grafana.md b/src/data/markdown/docs/01 guides/04 Results visualization/05 InfluxDB - Grafana.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/05 InfluxDB - Grafana.md
rename to src/data/markdown/docs/01 guides/04 Results visualization/05 InfluxDB - Grafana.md
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/06 JSON.md b/src/data/markdown/docs/01 guides/04 Results visualization/06 JSON.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/06 JSON.md
rename to src/data/markdown/docs/01 guides/04 Results visualization/06 JSON.md
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/07 NewRelic.md b/src/data/markdown/docs/01 guides/04 Results visualization/07 NewRelic.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/07 NewRelic.md
rename to src/data/markdown/docs/01 guides/04 Results visualization/07 NewRelic.md
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/08 StatsD.md b/src/data/markdown/docs/01 guides/04 Results visualization/08 StatsD.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/08 StatsD.md
rename to src/data/markdown/docs/01 guides/04 Results visualization/08 StatsD.md
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/Cloud/k6-cloud-results.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/Cloud/k6-cloud-results.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/Cloud/k6-cloud-results.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/Cloud/k6-cloud-results.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/CloudWatch/cloudwatch-k6-dashboard.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/CloudWatch/cloudwatch-k6-dashboard.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/CloudWatch/cloudwatch-k6-dashboard.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/CloudWatch/cloudwatch-k6-dashboard.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/CloudWatch/cloudwatch-k6-metrics.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/CloudWatch/cloudwatch-k6-metrics.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/CloudWatch/cloudwatch-k6-metrics.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/CloudWatch/cloudwatch-k6-metrics.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/DataDog/datadog-performance-testing-metrics.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/DataDog/datadog-performance-testing-metrics.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/DataDog/datadog-performance-testing-metrics.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/DataDog/datadog-performance-testing-metrics.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/DataDog/k6-datadog-dashboard.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/DataDog/k6-datadog-dashboard.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/DataDog/k6-datadog-dashboard.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/DataDog/k6-datadog-dashboard.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-configure-graph-panel.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-configure-graph-panel.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-configure-graph-panel.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-configure-graph-panel.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-create-data-source.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-create-data-source.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-create-data-source.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-create-data-source.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-dave.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-dave.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-dave.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-dave.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-edit-metric.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-edit-metric.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-edit-metric.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-edit-metric.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-new-dashboard.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-new-dashboard.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-new-dashboard.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-new-dashboard.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-new-graph-panel.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-new-graph-panel.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-new-graph-panel.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-new-graph-panel.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-visualization.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-visualization.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/InfluxDB-Grafana/grafana-visualization.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/InfluxDB-Grafana/grafana-visualization.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/NewRelic/new-relic-dashboard.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/NewRelic/new-relic-dashboard.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/NewRelic/new-relic-dashboard.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/NewRelic/new-relic-dashboard.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/NewRelic/new-relic-data-explorer.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/NewRelic/new-relic-data-explorer.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/NewRelic/new-relic-data-explorer.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/NewRelic/new-relic-data-explorer.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-cli-get-started.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-cli-get-started.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-cli-get-started.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-cli-get-started.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-cli-instructions.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-cli-instructions.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-cli-instructions.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-cli-instructions.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-cli-screen.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-cli-screen.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-cli-screen.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-cli-screen.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-dashboard-listing-with-k6-dashboard.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-dashboard-listing-with-k6-dashboard.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-dashboard-listing-with-k6-dashboard.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-dashboard-listing-with-k6-dashboard.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-k6-cloud-output.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-k6-cloud-output.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-k6-cloud-output.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-k6-cloud-output.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-onboarding-screen.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-onboarding-screen.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-onboarding-screen.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-onboarding-screen.png
diff --git a/src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-test-results-new-result-screen.png b/src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-test-results-new-result-screen.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/03 Results visualization/images/[unused]-test-results-new-result-screen.png
rename to src/data/markdown/docs/01 guides/04 Results visualization/images/[unused]-test-results-new-result-screen.png
diff --git a/src/data/markdown/docs/01 guides/05 Testing Guides/01 API load testing.md b/src/data/markdown/docs/01 guides/06 Testing Guides/01 API load testing.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/05 Testing Guides/01 API load testing.md
rename to src/data/markdown/docs/01 guides/06 Testing Guides/01 API load testing.md
diff --git a/src/data/markdown/docs/01 guides/05 Testing Guides/02 Automated performance testing.md b/src/data/markdown/docs/01 guides/06 Testing Guides/02 Automated performance testing.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/05 Testing Guides/02 Automated performance testing.md
rename to src/data/markdown/docs/01 guides/06 Testing Guides/02 Automated performance testing.md
diff --git a/src/data/markdown/docs/01 guides/05 Testing Guides/03 Load testing websites.md b/src/data/markdown/docs/01 guides/06 Testing Guides/03 Load testing websites.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/05 Testing Guides/03 Load testing websites.md
rename to src/data/markdown/docs/01 guides/06 Testing Guides/03 Load testing websites.md
diff --git a/src/data/markdown/docs/01 guides/05 Testing Guides/04 Running large tests.md b/src/data/markdown/docs/01 guides/06 Testing Guides/04 Running large tests.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/05 Testing Guides/04 Running large tests.md
rename to src/data/markdown/docs/01 guides/06 Testing Guides/04 Running large tests.md
diff --git a/src/data/markdown/docs/01 guides/05 Testing Guides/images/Frontend-Backend-LoadTesting.png b/src/data/markdown/docs/01 guides/06 Testing Guides/images/Frontend-Backend-LoadTesting.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/05 Testing Guides/images/Frontend-Backend-LoadTesting.png
rename to src/data/markdown/docs/01 guides/06 Testing Guides/images/Frontend-Backend-LoadTesting.png
diff --git a/src/data/markdown/docs/01 guides/05 Testing Guides/images/large-scale-testing-3-terminals.png b/src/data/markdown/docs/01 guides/06 Testing Guides/images/large-scale-testing-3-terminals.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/05 Testing Guides/images/large-scale-testing-3-terminals.png
rename to src/data/markdown/docs/01 guides/06 Testing Guides/images/large-scale-testing-3-terminals.png
diff --git a/src/data/markdown/docs/01 guides/05 Testing Guides/images/our-tools.png b/src/data/markdown/docs/01 guides/06 Testing Guides/images/our-tools.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/05 Testing Guides/images/our-tools.png
rename to src/data/markdown/docs/01 guides/06 Testing Guides/images/our-tools.png
diff --git a/src/data/markdown/docs/01 guides/05 Testing Guides/images/postman-export.png b/src/data/markdown/docs/01 guides/06 Testing Guides/images/postman-export.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/05 Testing Guides/images/postman-export.png
rename to src/data/markdown/docs/01 guides/06 Testing Guides/images/postman-export.png
diff --git a/src/data/markdown/docs/01 guides/05 Testing Guides/images/vu-iteration-duration-k6-cli.png b/src/data/markdown/docs/01 guides/06 Testing Guides/images/vu-iteration-duration-k6-cli.png
similarity index 100%
rename from src/data/markdown/docs/01 guides/05 Testing Guides/images/vu-iteration-duration-k6-cli.png
rename to src/data/markdown/docs/01 guides/06 Testing Guides/images/vu-iteration-duration-k6-cli.png
diff --git a/src/data/markdown/docs/01 guides/06 Misc/01 Usage reports.md b/src/data/markdown/docs/01 guides/07 Misc/01 Usage reports.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/06 Misc/01 Usage reports.md
rename to src/data/markdown/docs/01 guides/07 Misc/01 Usage reports.md
diff --git a/src/data/markdown/docs/01 guides/06 Misc/02 IntelliSense.md b/src/data/markdown/docs/01 guides/07 Misc/02 IntelliSense.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/06 Misc/02 IntelliSense.md
rename to src/data/markdown/docs/01 guides/07 Misc/02 IntelliSense.md
diff --git a/src/data/markdown/docs/01 guides/06 Misc/03 Fine tuning OS.md b/src/data/markdown/docs/01 guides/07 Misc/03 Fine tuning OS.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/06 Misc/03 Fine tuning OS.md
rename to src/data/markdown/docs/01 guides/07 Misc/03 Fine tuning OS.md
diff --git a/src/data/markdown/docs/01 guides/06 Misc/04 k6 REST API.md b/src/data/markdown/docs/01 guides/07 Misc/04 k6 REST API.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/06 Misc/04 k6 REST API.md
rename to src/data/markdown/docs/01 guides/07 Misc/04 k6 REST API.md
diff --git a/src/data/markdown/docs/01 guides/06 Misc/05 Archive.md b/src/data/markdown/docs/01 guides/07 Misc/05 Archive.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/06 Misc/05 Archive.md
rename to src/data/markdown/docs/01 guides/07 Misc/05 Archive.md
diff --git a/src/data/markdown/docs/01 guides/06 Misc/06 Glossary.md b/src/data/markdown/docs/01 guides/07 Misc/06 Glossary.md
similarity index 100%
rename from src/data/markdown/docs/01 guides/06 Misc/06 Glossary.md
rename to src/data/markdown/docs/01 guides/07 Misc/06 Glossary.md
diff --git a/src/data/markdown/docs/01 guides/06 Misc/images/intellisense-k6-demo.gif b/src/data/markdown/docs/01 guides/07 Misc/images/intellisense-k6-demo.gif
similarity index 100%
rename from src/data/markdown/docs/01 guides/06 Misc/images/intellisense-k6-demo.gif
rename to src/data/markdown/docs/01 guides/07 Misc/images/intellisense-k6-demo.gif
diff --git a/src/data/markdown/docs/03 cloud/01 Creating and running a test/01 Test Builder.md b/src/data/markdown/docs/03 cloud/01 Creating and running a test/01 Test Builder.md
deleted file mode 100644
index 854cbd57da..0000000000
--- a/src/data/markdown/docs/03 cloud/01 Creating and running a test/01 Test Builder.md
+++ /dev/null
@@ -1,81 +0,0 @@
----
-title: 'Test Builder'
-excerpt: 'Details on using the k6 Request Builder to generate test scripts and take the guess work out of scripting'
----
-
-## Background
-
-The k6 Test Builder allows you to utilize a graphical interface to create a test script.
-Based on your inputs, we will automatically generate the proper required JavaScript to
-execute the test within the app or from the command line. Use the Test Builder to help
-speed up your scripting efforts.
-
-> ### HAR Import
->
-> The test builder also accepts importing a HAR file. When creating your HAR file, you
-> should filter out third party requests and be mindful of your session length. Too many
-> requests as a result of a long journey or third party requests will be overwhelming.
-
-## Test Builder Configuration
-
-The top configuration section allows to:
-
-- `Create` (save) or `Create and Run` your test
-- Give your test a meaningful name
-- Import a HAR file
-- Configure ramping, VUs, and duration
-
-To input a HAR file, simply click on `IMPORT HAR` on the right, and select your file to be converted.
-We will automatically populate the Test Builder with your requests, including any `Headers` sent.
-You are able to modify/delete various parts of the requests to meet your requirements.
-
-
-
-## Test Builder Requests
-
-Whether you are importing a HAR file or starting from a blank slate, the `REQUESTS` section
-allows you to explicitly control requests, the data sent with them, and even save data from the response.
-
-Requests will be listed in order on the left. You can reorganize requests by clicking and dragging.
-You can also duplicate or delete requests when hovering over a specific request.
-To add a new request, click `ADD REQUEST`. Your test will execute in the order of these requests.
-
-To modify requests, move over to the right side of the `REQUESTS` section. You are able to:
-
-- Give your request a name to better describe it.
-- Change the `HTTP METHOD` by using the drop down pre-populated with `GET`.
-- Change the URL/Endpoint (This is predefine as `http://test.k6.io/` for example purposes)
-- Specify Headers (If you have imported a HAR file, we will include some Headers here)
-- Specify Query Parameters
-- Create Checks
-- Capture a variable (Helpful for dealing with dynamic data, such as authentication tokens)
-- For POST/PUT/PATCH, you can also specify a request body (JSON, Text, or File Content)
-
-> ### Examples
->
-> We also include some examples of common actions. This is accessible by using the
-> `Test builder examples` drop down in the title bar of the section. Use these for
-> inspiration and guidance as you use the test builder.
->
->
-> **NOTE:** Choosing one of the examples will replace the current requests in the Test Builder.
-
-
-
-## Test Builder Script
-
-After you have completed building your requests. You can click on the `>` in the
-top right corner of the title bar to view the script we have generated for you.
-
-This script is syntactically correct and may be used run right from the web app.
-You may wish to copy it to your local IDE to place in version control, parameterize data,
-or add more business logic. It's highly recommended to add some Thresholds.
-
-If this is your first time using the Test Builder or k6. We recommend taking a moment to
-familiarize yourself with the generated script and how the different parts relate to inputs.
-For example, the option object reflects your configuration, names of requests are comments above the
-actual requests, checks are implemented with requests, and more.
-
-## See Also
-
-- [Projects](/cloud/analyzing-results/analysis-tab)
diff --git a/src/data/markdown/docs/03 cloud/01 Creating and running a test/01 Test authoring.md b/src/data/markdown/docs/03 cloud/01 Creating and running a test/01 Test authoring.md
new file mode 100644
index 0000000000..ed3ffdc229
--- /dev/null
+++ b/src/data/markdown/docs/03 cloud/01 Creating and running a test/01 Test authoring.md
@@ -0,0 +1,25 @@
+---
+title: 'Test authoring'
+excerpt: ''
+---
+
+In testing, authoring refers to the test creation process.
+
+k6 is, at its core, a **Code-based testing tool**. However, the k6 ecosystem provides a set of **codeless tools** to speed up the test creation and facilitate collaboration across different roles.
+
+In k6, you could create a test using various tools:
+
+- Your own text editor or IDE
+- [Script editor in the k6 Cloud](/cloud/creating-and-running-a-test/script-editor)
+- [Test builder](/test-authoring/test-builder)
+- [Browser recorder](/test-authoring/recording-a-session/browser-recorder)
+- [Converters](/integrations#converters): JMeter, Postman and Swagger
+
+## Running a cloud test
+
+After creating your test, you might want to debug it locally or run it on the cloud. Cloud tests will be executed from the geographic location/s you've selected in your test, on k6 Cloud infrastructure.
+
+If you want to run a cloud test, there are two main places where you could start it:
+
+- In the **k6 Cloud web app**, using the [script editor](/cloud/creating-and-running-a-test/script-editor), [test builder](/test-authoring/test-builder), or re-running a listed test.
+- In the **k6 CLI**, [running the k6 cloud command](/creating-and-running-a-test/cloud-tests-from-the-cli).
diff --git a/src/data/markdown/docs/03 cloud/01 Creating and running a test/03 In-app script editor.md b/src/data/markdown/docs/03 cloud/01 Creating and running a test/03 script editor.md
similarity index 57%
rename from src/data/markdown/docs/03 cloud/01 Creating and running a test/03 In-app script editor.md
rename to src/data/markdown/docs/03 cloud/01 Creating and running a test/03 script editor.md
index 35d26c1a7f..1b517283be 100644
--- a/src/data/markdown/docs/03 cloud/01 Creating and running a test/03 In-app script editor.md
+++ b/src/data/markdown/docs/03 cloud/01 Creating and running a test/03 script editor.md
@@ -1,23 +1,25 @@
---
-title: 'In-app script editor'
-excerpt: 'How to use the k6 in-app script editor'
+title: 'Script editor'
+excerpt: 'How to use the script editor in the k6 Cloud'
---
+The script editor is designed to allow you to quickly write test scripts from within the web app.
+
+We believe most users will quickly graduate to using k6 as a CLI locally together with their IDE of choice. However, organizational security rules vary from organization to organization and some may not be able to install applications without a review from their security team. The script editor allows you to utilize just about all features of k6 right within the web app.
+
+Use the script editor as a stepping stone, if needed, before you move to running [cloud tests from the CLI](/cloud/creating-and-running-a-test/cloud-tests-from-the-cli).
+
-#### Limitations of the in-app editor
+#### Limitations of the script editor
-The in-app editor has access to all built-in k6 modules and remote modules available via
+The script editor has access to all built-in k6 modules and remote modules available via
the web. If you need to import a custom library or file for parameterization, you
must trigger your test using the CLI.
-## Background
-
-The in-app script is designed to allow you to quickly write and mock up test scripts right within the web app. We believe most users will quickly graduate to using k6 as a CLI and their IDE of choice locally. However, organizational security rules vary from organization to organization and some may not be able to install a program without review from their security team. The script editor allows you to utilize just about all features of k6 right within the web app.
-
-Use the script editor as a stepping stone, if needed, before you move to running tests from the command line.
+
## Usage
diff --git a/src/data/markdown/docs/03 cloud/01 Creating and running a test/04 Recording a test script.md b/src/data/markdown/docs/03 cloud/01 Creating and running a test/04 Recording a test script.md
deleted file mode 100644
index 347b61dbda..0000000000
--- a/src/data/markdown/docs/03 cloud/01 Creating and running a test/04 Recording a test script.md
+++ /dev/null
@@ -1,44 +0,0 @@
----
-title: 'Recording a test script'
-excerpt: 'A guide on how to use the k6 Cloud Chrome extension to record user behavior to quickly create load test scripts.'
----
-
-## Background
-
-The k6 Cloud Test Script Recorder Chrome extension allows you to generate the bulk of your test scripts simply by browsing like a user would on your site or web app. The script created gives you a foundation which you can further edit, as required.
-
-The k6 Cloud Chrome extension will capture everything – every single HTTP(s) request being loaded into the browser as you click – including ads, images, documents, etc., so you get a far more accurate read of what’s going on. Just press “record”, start browsing and when complete, the script will automatically upload to your k6 Cloud account.
-
-> #### Consider this:
->
-> The Chrome extension will not record other tabs or pop up windows. If you need to capture this information, you should check out [converting from a HAR file](/using-k6/session-recording-har-support).
-
-_Note:_ Before you begin, please be sure to force refresh the k6 Cloud app to ensure you are on the most recent version of the k6 Cloud app.
-
-## Here's how to start:
-
-1. Download and install the k6 Browser Recorder.
-
-2. **Start a recording**
- Open the extension by clicking the k6 logo, and press "Start recording" to begin recording the current browser tab. Now browse like a user would or how you want our Virtual Users to execute. We suggest basing this on _real user behavior_ - don't try to visit every single page on your site or app. Focus on common journeys.
- 
-
-3. **Stop recording**
- When done, press "Stop recording", you'll be taken to the app to review the recorded test script
- 
-
-4. **Save your test scripts**
- Save the recorded script in any of your projects.
- If any _third party requests_ or requests to download assets were made during the recording those requests will be filtered out by default.
- Would you want to include some of the requests in the _third party list_ simply deselect the ones you want to include then hit save.
- 
-
-5. **You can now edit your script as necessary.** k6 Cloud's in app IDE will update in real time to alert you of any syntax errors. You may need to edit your script to deal with CSRF tokens, adding advanced business logic, creating custom metrics, etc.
-
-6. **Once done, press run to start your test**
-
-> #### Important things to note
->
-> - The default configuration will be a 12 minute test that ramps to 10 Virtual Users over 1 minute, stays at 10 for 10 minutes, then ramps back to 0 over 1 minute. You can change this in the stages section of the script. Refer to [this article](/test-types/introduction) for more information on ramping configurations.
-> - No load zone is specified and it will run out of Ashburn by default. You can specify different load zones by adding a `ext.loadimpact.distribution` option. See [this article](/using-k6/options) for more information
-> - We have set `discardResponseBodies: true`. This will discard all response bodies by default.
diff --git a/src/data/markdown/docs/03 cloud/01 Creating and running a test/05 Converters.md b/src/data/markdown/docs/03 cloud/01 Creating and running a test/05 Converters.md
deleted file mode 100644
index fafce860e6..0000000000
--- a/src/data/markdown/docs/03 cloud/01 Creating and running a test/05 Converters.md
+++ /dev/null
@@ -1,13 +0,0 @@
----
-title: 'Converters'
-excerpt: 'Use the k6 converters to turn your existing Postman collection, swagger file, or jmx files into the foundation of your next test'
----
-
-The k6 converters can help you to generate a k6 script quickly. Use the k6 converters to turn your existing Postman collection, swagger file, or jmx files into the foundation of your k6 test.
-
-| Converter | Description |
-| ---------- | ---------------------------------------------------- |
-| [JMeter-to-k6](https://github.com/loadimpact/jmeter-to-k6) | Convert a JMeter .jmx file to k6 script. |
-| [Postman-to-k6](https://github.com/loadimpact/postman-to-k6) | Convert a Postman collection to k6 script.. |
-| [OpenAPI generator](https://k6.io/blog/load-testing-your-api-with-swagger-openapi-and-k6) | Convert Swagger/OpenAPI specification to k6 script. |
-| [HAR-to-k6](https://github.com/loadimpact/har-to-k6) | Convert a HAR file to k6 script. |
\ No newline at end of file
diff --git a/src/data/markdown/docs/03 cloud/01 Creating and running a test/06 Scheduling a test.md b/src/data/markdown/docs/03 cloud/01 Creating and running a test/06 Scheduling a test.md
index 5cf957b26e..e8e159febd 100644
--- a/src/data/markdown/docs/03 cloud/01 Creating and running a test/06 Scheduling a test.md
+++ b/src/data/markdown/docs/03 cloud/01 Creating and running a test/06 Scheduling a test.md
@@ -1,10 +1,8 @@
---
-title: 'Scheduling Tests'
+title: 'Scheduling tests'
excerpt: 'A guide on how to schedule your load tests to run in the future or on a schedule within the k6 Cloud Web UI.'
---
-## Background
-
It's not always feasible to be able to trigger a test to run when you need it. The scheduling option in k6 Cloud allows you to configure a test to execute at a particular time, and on a regular interval, if needed.
Some reasons include, but are not limited to:
diff --git a/src/data/markdown/docs/03 cloud/01 Creating and running a test/images/script-editor.png b/src/data/markdown/docs/03 cloud/01 Creating and running a test/images/script-editor.png
new file mode 100644
index 0000000000..6912554aa2
Binary files /dev/null and b/src/data/markdown/docs/03 cloud/01 Creating and running a test/images/script-editor.png differ
diff --git a/src/data/markdown/docs/04 integrations/01 Test authoring/01 test-builder.md b/src/data/markdown/docs/04 integrations/01 Test authoring/01 test-builder.md
new file mode 100644
index 0000000000..622d6e0209
--- /dev/null
+++ b/src/data/markdown/docs/04 integrations/01 Test authoring/01 test-builder.md
@@ -0,0 +1,4 @@
+---
+title: 'Test Builder'
+redirect: 'https://k6.io/docs/test-authoring/test-builder'
+---
diff --git a/src/data/markdown/docs/04 integrations/01 Test authoring/02 browser-recorder.md b/src/data/markdown/docs/04 integrations/01 Test authoring/02 browser-recorder.md
new file mode 100644
index 0000000000..4f54b5dc90
--- /dev/null
+++ b/src/data/markdown/docs/04 integrations/01 Test authoring/02 browser-recorder.md
@@ -0,0 +1,4 @@
+---
+title: 'Browser Recorder'
+redirect: 'https://k6.io/docs/test-authoring/recording-a-session/browser-recorder'
+---
diff --git a/src/data/markdown/docs/04 integrations/03 IDE/01 vscode.md b/src/data/markdown/docs/04 integrations/02 IDE extensions/01 vscode.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/03 IDE/01 vscode.md
rename to src/data/markdown/docs/04 integrations/02 IDE extensions/01 vscode.md
diff --git a/src/data/markdown/docs/04 integrations/03 IDE/02 intellisense.md b/src/data/markdown/docs/04 integrations/02 IDE extensions/02 intellisense.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/03 IDE/02 intellisense.md
rename to src/data/markdown/docs/04 integrations/02 IDE extensions/02 intellisense.md
diff --git a/src/data/markdown/docs/04 integrations/01 Converters/01 har-to-k6.md b/src/data/markdown/docs/04 integrations/03 Converters/01 har-to-k6.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/01 Converters/01 har-to-k6.md
rename to src/data/markdown/docs/04 integrations/03 Converters/01 har-to-k6.md
diff --git a/src/data/markdown/docs/04 integrations/01 Converters/02 jmeter-to-k6.md b/src/data/markdown/docs/04 integrations/03 Converters/02 jmeter-to-k6.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/01 Converters/02 jmeter-to-k6.md
rename to src/data/markdown/docs/04 integrations/03 Converters/02 jmeter-to-k6.md
diff --git a/src/data/markdown/docs/04 integrations/01 Converters/03 postman-to-k6.md b/src/data/markdown/docs/04 integrations/03 Converters/03 postman-to-k6.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/01 Converters/03 postman-to-k6.md
rename to src/data/markdown/docs/04 integrations/03 Converters/03 postman-to-k6.md
diff --git a/src/data/markdown/docs/04 integrations/01 Converters/04 openapi-generator.md b/src/data/markdown/docs/04 integrations/03 Converters/04 openapi-generator.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/01 Converters/04 openapi-generator.md
rename to src/data/markdown/docs/04 integrations/03 Converters/04 openapi-generator.md
diff --git a/src/data/markdown/docs/04 integrations/02 Results visualization/01 amazon-cloudwatch.md b/src/data/markdown/docs/04 integrations/04 Results visualization/01 amazon-cloudwatch.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/02 Results visualization/01 amazon-cloudwatch.md
rename to src/data/markdown/docs/04 integrations/04 Results visualization/01 amazon-cloudwatch.md
diff --git a/src/data/markdown/docs/04 integrations/02 Results visualization/01 kafka.md b/src/data/markdown/docs/04 integrations/04 Results visualization/01 kafka.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/02 Results visualization/01 kafka.md
rename to src/data/markdown/docs/04 integrations/04 Results visualization/01 kafka.md
diff --git a/src/data/markdown/docs/04 integrations/02 Results visualization/02 cloud-service.md b/src/data/markdown/docs/04 integrations/04 Results visualization/02 cloud-service.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/02 Results visualization/02 cloud-service.md
rename to src/data/markdown/docs/04 integrations/04 Results visualization/02 cloud-service.md
diff --git a/src/data/markdown/docs/04 integrations/02 Results visualization/03 csv.md b/src/data/markdown/docs/04 integrations/04 Results visualization/03 csv.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/02 Results visualization/03 csv.md
rename to src/data/markdown/docs/04 integrations/04 Results visualization/03 csv.md
diff --git a/src/data/markdown/docs/04 integrations/02 Results visualization/04 datadog.md b/src/data/markdown/docs/04 integrations/04 Results visualization/04 datadog.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/02 Results visualization/04 datadog.md
rename to src/data/markdown/docs/04 integrations/04 Results visualization/04 datadog.md
diff --git a/src/data/markdown/docs/04 integrations/02 Results visualization/05 influxdb-grafana.md b/src/data/markdown/docs/04 integrations/04 Results visualization/05 influxdb-grafana.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/02 Results visualization/05 influxdb-grafana.md
rename to src/data/markdown/docs/04 integrations/04 Results visualization/05 influxdb-grafana.md
diff --git a/src/data/markdown/docs/04 integrations/02 Results visualization/06 json.md b/src/data/markdown/docs/04 integrations/04 Results visualization/06 json.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/02 Results visualization/06 json.md
rename to src/data/markdown/docs/04 integrations/04 Results visualization/06 json.md
diff --git a/src/data/markdown/docs/04 integrations/02 Results visualization/07 new relic.md b/src/data/markdown/docs/04 integrations/04 Results visualization/07 new relic.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/02 Results visualization/07 new relic.md
rename to src/data/markdown/docs/04 integrations/04 Results visualization/07 new relic.md
diff --git a/src/data/markdown/docs/04 integrations/02 Results visualization/08 statsd.md b/src/data/markdown/docs/04 integrations/04 Results visualization/08 statsd.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/02 Results visualization/08 statsd.md
rename to src/data/markdown/docs/04 integrations/04 Results visualization/08 statsd.md
diff --git a/src/data/markdown/docs/04 integrations/04 CI tools/01 azure.md b/src/data/markdown/docs/04 integrations/05 CI tools/01 azure.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/04 CI tools/01 azure.md
rename to src/data/markdown/docs/04 integrations/05 CI tools/01 azure.md
diff --git a/src/data/markdown/docs/04 integrations/04 CI tools/02 circleci.md b/src/data/markdown/docs/04 integrations/05 CI tools/02 circleci.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/04 CI tools/02 circleci.md
rename to src/data/markdown/docs/04 integrations/05 CI tools/02 circleci.md
diff --git a/src/data/markdown/docs/04 integrations/04 CI tools/03 github.md b/src/data/markdown/docs/04 integrations/05 CI tools/03 github.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/04 CI tools/03 github.md
rename to src/data/markdown/docs/04 integrations/05 CI tools/03 github.md
diff --git a/src/data/markdown/docs/04 integrations/04 CI tools/04 gitlab.md b/src/data/markdown/docs/04 integrations/05 CI tools/04 gitlab.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/04 CI tools/04 gitlab.md
rename to src/data/markdown/docs/04 integrations/05 CI tools/04 gitlab.md
diff --git a/src/data/markdown/docs/04 integrations/04 CI tools/05 jenkins.md b/src/data/markdown/docs/04 integrations/05 CI tools/05 jenkins.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/04 CI tools/05 jenkins.md
rename to src/data/markdown/docs/04 integrations/05 CI tools/05 jenkins.md
diff --git a/src/data/markdown/docs/04 integrations/04 CI tools/06 teamcity.md b/src/data/markdown/docs/04 integrations/05 CI tools/06 teamcity.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/04 CI tools/06 teamcity.md
rename to src/data/markdown/docs/04 integrations/05 CI tools/06 teamcity.md
diff --git a/src/data/markdown/docs/04 integrations/05 Community integrations/01 easy-graphql.md b/src/data/markdown/docs/04 integrations/06 Community integrations/01 easy-graphql.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/05 Community integrations/01 easy-graphql.md
rename to src/data/markdown/docs/04 integrations/06 Community integrations/01 easy-graphql.md
diff --git a/src/data/markdown/docs/04 integrations/05 Community integrations/02 azure-integration.md b/src/data/markdown/docs/04 integrations/06 Community integrations/02 azure-integration.md
similarity index 100%
rename from src/data/markdown/docs/04 integrations/05 Community integrations/02 azure-integration.md
rename to src/data/markdown/docs/04 integrations/06 Community integrations/02 azure-integration.md
diff --git a/src/images/doc-integrations/browser-recorder.png b/src/images/doc-integrations/browser-recorder.png
new file mode 100644
index 0000000000..c0af47489b
Binary files /dev/null and b/src/images/doc-integrations/browser-recorder.png differ
diff --git a/src/images/doc-integrations/k6.png b/src/images/doc-integrations/k6.png
new file mode 100644
index 0000000000..0419299be0
Binary files /dev/null and b/src/images/doc-integrations/k6.png differ
diff --git a/src/images/doc-integrations/test-builder.png b/src/images/doc-integrations/test-builder.png
new file mode 100644
index 0000000000..b86894e2b2
Binary files /dev/null and b/src/images/doc-integrations/test-builder.png differ
diff --git a/src/svg/browser-recorder.svg b/src/svg/browser-recorder.svg
new file mode 100644
index 0000000000..60f4a169d0
--- /dev/null
+++ b/src/svg/browser-recorder.svg
@@ -0,0 +1,7 @@
+
diff --git a/src/svg/test-builder.svg b/src/svg/test-builder.svg
new file mode 100644
index 0000000000..025468fbbf
--- /dev/null
+++ b/src/svg/test-builder.svg
@@ -0,0 +1,14 @@
+
diff --git a/src/templates/docs/cloud.js b/src/templates/docs/cloud.js
index a7a250fc5d..020f3043a1 100644
--- a/src/templates/docs/cloud.js
+++ b/src/templates/docs/cloud.js
@@ -88,9 +88,7 @@ export default function ({ pageContext: { sidebarTree, navLinks } }) {
{' '}
and{' '}
Script Editor
@@ -100,10 +98,10 @@ export default function ({ pageContext: { sidebarTree, navLinks } }) {
CLI and{' '}
- Browser Session Recorder
+ Browser Recorder
.
diff --git a/src/templates/docs/integrations.js b/src/templates/docs/integrations.js
index c931ed761c..6056c63bde 100644
--- a/src/templates/docs/integrations.js
+++ b/src/templates/docs/integrations.js
@@ -127,6 +127,12 @@ export default function ({ pageContext: { sidebarTree, navLinks } }) {
vscodeImg: {
childImageSharp: { fixed: vscodeImgData },
},
+ browserRecorderImg: {
+ childImageSharp: { fixed: browserRecorderImgData },
+ },
+ testBuilderImg: {
+ childImageSharp: { fixed: testBuilderImgData },
+ },
harImg: {
childImageSharp: { fixed: harImgData },
},
@@ -168,6 +174,24 @@ export default function ({ pageContext: { sidebarTree, navLinks } }) {
}
}
}
+ testBuilderImg: file(
+ absolutePath: { regex: "/images/doc-integrations/test-builder/" }
+ ) {
+ childImageSharp {
+ fixed(width: 60, height: 60, cropFocus: CENTER) {
+ ...GatsbyImageSharpFixed_withWebp_noBase64
+ }
+ }
+ }
+ browserRecorderImg: file(
+ absolutePath: { regex: "/images/doc-integrations/browser-recorder/" }
+ ) {
+ childImageSharp {
+ fixed(width: 60, height: 60, cropFocus: CENTER) {
+ ...GatsbyImageSharpFixed_withWebp_noBase64
+ }
+ }
+ }
harImg: file(absolutePath: { regex: "/images/doc-integrations/har/" }) {
childImageSharp {
fixed(width: 60, height: 60, cropFocus: CENTER) {
@@ -219,8 +243,52 @@ export default function ({ pageContext: { sidebarTree, navLinks } }) {