Merge pull request #415 from checkly/docs/fix-broken-links

Fix broken and degraded links found by full-content link audit

Author: sbezludny

ai/llms-txt.mdx

@@ -16,11 +16,9 @@ The [llms.txt standard](https://llmstxt.org/) provides a machine-readable index
 - [Adding team members to your Checkly account](https://checklyhq.com/docs/admin/team-management/adding-team-members.md): Learn how to invite team members to join your Checkly account and manage team collaboration
 - [Using Microsoft Entra ID for Single Sign-on in Checkly](https://checklyhq.com/docs/admin/team-management/microsoft-azure-ad.md): This page illustrates the standard procedure to follow in order to get started with Microsoft Entra ID SSO (formerly Azure AD) on Checkly.
 - [Multi-Factor Authentication in Checkly](https://checklyhq.com/docs/admin/team-management/multi-factor-authentication.md): Learn how to set up and manage multi-factor authentication for enhanced account security
-- [Using Okta for Single Sign-on in Checkly](https://checklyhq.com/docs/admin/team-management/okta.md): This page illustrates the standard procedure to follow in order to get started with Okta SSO on Checkly.
-- [Role Based Access Control in Checkly](https://checklyhq.com/docs/admin/team-management/rbac.md): Checkly roles and permissions for team members
-- [Removing team members from your Checkly account](https://checklyhq.com/docs/admin/team-management/removing-team-members.md): Learn how to remove team members from your Checkly account and understand how it affects your billing
-- [Using SAML for Single Sign-On in Checkly](https://checklyhq.com/docs/admin/team-management/saml-sso.md): Learn how to set up SAML-based SSO for your Checkly account with supported identity providers
-- [Using SCIM provisioning in Checkly](https://checklyhq.com/docs/admin/team-management/scim-provisioning.md): Learn how to set up SCIM provisioning for Checkly using your identity provider
+- [Admin Overview](https://checklyhq.com/docs/admin/team-management/overview.md): Comprehensive guide to managing your Checkly account, team members, security, and integrations
+- [SAML for Single Sign-on in Checkly](https://checklyhq.com/docs/admin/team-management/saml.md): Learn how to configure SAML SSO integration with Checkly for your organization
+- [Single Sign-on in Checkly](https://checklyhq.com/docs/admin/team-management/single-sign-on.md): Overview of Single Sign-On (SSO) options available in Checkly for enterprise security
 - [Team management in Checkly](https://checklyhq.com/docs/admin/team-management.md): Manage your team and collaborate effectively in Checkly
 ```
 

detect/synthetic-monitoring/browser-checks/file-system.mdx

@@ -138,7 +138,7 @@ import { test, expect } from '@playwright/test'
 test('Upload a file using a POST request', async ({ request }) => {
   const fileUrl  = 'https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf'
   const fileBuffer  = await request.get(fileUrl)
-  const response = await request.post('https://filebin.net/pp9on3zvwv7zq6lm/dummy.pdf', {
+  const response = await request.post('https://httpbin.org/post', {
     data: await fileBuffer.body(),
   })
   await expect(response).toBeOK()
@@ -151,7 +151,7 @@ const { test, expect } = require('@playwright/test')
 test('Upload a file using a POST request', async ({ request }) => {
   const fileUrl  = 'https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf'
   const fileBuffer  = await request.get(fileUrl)
-  const response = await request.post('https://filebin.net/pp9on3zvwv7zq6lm/dummy.pdf', {
+  const response = await request.post('https://httpbin.org/post', {
     data: await fileBuffer.body(),
   })
   await expect(response).toBeOK()

detect/synthetic-monitoring/multistep-checks/file-system.mdx

@@ -27,7 +27,7 @@ test('Upload a file using a POST request', async ({ request }) => {
   })
 
   await test.step('Upload file', async () => {
-    const response = await request.post('https://filebin.net/pp9on3zvwv7zq6lm/dummy.pdf', {
+    const response = await request.post('https://httpbin.org/post', {
       data: await fileBuffer.body(),
     })
     await expect(response).toBeOK()
@@ -45,7 +45,7 @@ test('Upload a file using a POST request', async ({ request }) => {
   })
 
   await test.step('Upload file', async () => {
-    const response = await request.post('https://filebin.net/pp9on3zvwv7zq6lm/dummy.pdf', {
+    const response = await request.post('https://httpbin.org/post', {
       data: await fileBuffer.body(),
     })
     await expect(response).toBeOK()

detect/testing/playwright-reporter.mdx

@@ -17,7 +17,7 @@ Before using the Playwright reporter, ensure you have:
 
 - Node.js >= 18.0.0
 - Playwright >= 1.40.0
-- A Checkly account ([sign up](https://www.checklyhq.com/signup))
+- A Checkly account ([sign up](https://app.checklyhq.com/signup))
 </Accordion>
 
 ## Install the Playwright Reporter

docs.json

@@ -1415,6 +1415,14 @@
       "source": "/api-reference/error-groups/update-an-error-group-mainly-used-for-archiving-error-groups/",
       "destination": "/api-reference/error-groups/update-an-error-group"
     },
+    {
+      "source": "/monitoring/check-results",
+      "destination": "/concepts/results"
+    },
+    {
+      "source": "/detect/synthetic-monitoring/browser-checks/results",
+      "destination": "/concepts/results"
+    },
     {
       "source": "/assertions",
       "destination": "/detect/assertions"

guides/create-multiple-monitors.mdx

@@ -73,7 +73,7 @@ import { Frequency, UrlMonitor, UrlAssertionBuilder } from 'checkly/constructs'
 const sitemapUrls = [
     'https://www.checklyhq.com/docs/',
     'https://www.checklyhq.com/learn/playwright/codegen/',
-    'https://www.checklyhq.com/guides/using-pw-test-command/',
+    'https://www.checklyhq.com/docs/guides/setup-scripts-for-apis/',
     'https://www.checklyhq.com/docs/api-reference/incidents/create-an-incident/',
     'https://www.checklyhq.com/customers/'
 ]
@@ -132,7 +132,7 @@ In our previous check, we defined the URLs to monitor in an array at the top of
 const sitemapUrls = [
     'https://www.checklyhq.com/docs/',
     'https://www.checklyhq.com/learn/playwright/codegen/',
-    'https://www.checklyhq.com/guides/using-pw-test-command/',
+    'https://www.checklyhq.com/docs/guides/setup-scripts-for-apis/',
     'https://www.checklyhq.com/docs/api-reference/incidents/create-an-incident/',
     'https://www.checklyhq.com/customers/'
 ]
@@ -144,7 +144,7 @@ Rather than having to edit this check’s code every time we update our list of
 { "urls":[
     "https://www.checklyhq.com/docs/",
     "https://www.checklyhq.com/learn/playwright/codegen/",
-    "https://www.checklyhq.com/guides/using-pw-test-command/",
+    "https://www.checklyhq.com/docs/guides/setup-scripts-for-apis/",
     "https://www.checklyhq.com/docs/api-reference/incidents/create-an-incident/",
     "https://www.checklyhq.com/customers/"
 ]}
@@ -166,10 +166,10 @@ Let’s continue to increase the sophistication of our group of monitors. Right
 
 | url | logicalID | name |
 | --- | --- | --- |
-| [https://www.checklyhq.com/docs/](https://www.checklyhq.com/docs/,) | docs-1 | url monitor docs-1 |
-| [https://www.checklyhq.com/learn/playwright/codegen/](https://www.checklyhq.com/learn/playwright/codegen/,) | codegen-1 | url monitor codegen-1 |
-| [https://www.checklyhq.com/guides/using-pw-test-command/](https://www.checklyhq.com/guides/using-pw-test-command/,) | pw-test-1 | url monitor pw-test-1 |
-| [https://www.checklyhq.com/docs/api-reference/incidents/create-an-incident/](https://www.checklyhq.com/docs/api-reference/incidents/create-an-incident/,) | incidents-1 | url monitor incidents-1 |
+| `https://www.checklyhq.com/docs/` | docs-1 | url monitor docs-1 |
+| `https://www.checklyhq.com/learn/playwright/codegen/` | codegen-1 | url monitor codegen-1 |
+| `https://www.checklyhq.com/guides/using-pw-test-command/` | pw-test-1 | url monitor pw-test-1 |
+| `https://www.checklyhq.com/docs/api-reference/incidents/create-an-incident/` | incidents-1 | url monitor incidents-1 |
 
 And this version of the URL monitor fetches the CSV and parses the three values for each check from the row before creating a monitor.
 

guides/getting-started-with-monitoring-as-code.mdx

@@ -85,7 +85,7 @@ test('Checkly Docs', async ({ page }) => {
 
 ---
 
-This test uses the page.goto method to navigate to the specified URL (‘[https://www.checklyhq.com/docs/browser-checks/’](https://www.checklyhq.com/docs/browser-checks/%E2%80%99)). The method returns a response object, which is stored in the response variable.
+This test uses the page.goto method to navigate to the specified URL (`https://www.checklyhq.com/docs/browser-checks/`). The method returns a response object, which is stored in the response variable.
 
 Then we use the expect function to assert that the HTTP status code of the response is less than 400. This is a way to ensure that the page is loaded successfully without any HTTP errors.
 
@@ -142,7 +142,7 @@ To set up alerts for your check, go to the specific project, in this case, "home
 
 ![setting up alerts with checkly](/images/guides/images/guides-getting-started-alerts.jpeg "Setting up Alerts with Checkly")
 
-Here, configure monitoring parameters according to your needs, including check frequency, locations, retries and alerting. You can also set up your preferred alert channel using the Checkly CLI. Learn more about the alert channels from the [official documentation](https://www.checklyhq.com/cli/overviewconstructs-reference/#alertchannel).
+Here, configure monitoring parameters according to your needs, including check frequency, locations, retries and alerting. You can also set up your preferred alert channel using the Checkly CLI. Learn more about the alert channels from the [official documentation](/constructs/alert-channel).
 
 With the appropriate alert channels set up, there is no need for customers to regularly visit the dashboard. Instead, they will be promptly notified, allowing them to react immediately upon receiving alerts.
 

guides/monitoring-an-openapi-spec.mdx

@@ -15,7 +15,7 @@ Following the OAS brings the following advantages:
 2. The possibility of automatically generating documentation, implementation logic and even mock servers for testing.
 3. Early validation of the data flows happening within the API.
 
-For those new to the OAS and wanting to get a basic understanding without diving straight into the specification itself, the official [OpenAPI Specification Explained](https://oai.github.io/Documentation/specification.html) guide is a great place to start.
+For those new to the OAS and wanting to get a basic understanding without diving straight into the specification itself, the official [OpenAPI Specification Explained](https://learn.openapis.org/specification/) guide is a great place to start.
 
 ## Swagger vs OpenAPI
 
@@ -186,7 +186,7 @@ Depending on how much is described in a given API spec, it is possible to move e
 
 ## Generated monitoring checks with Checkly
 
-[API monitoring](/learn/monitoring/api-monitoring) is key to ensure that our endpoints are returning the correct results in an acceptable timeframe.  If we can generate APIs from a OAS description file, we can also generate monitoring checks for them. Checkly is [a member of the OpenAPI initiative](https://www.openapis.org/membership/members), and allows us to import an OpenAPI spec file and automatically creates one or more checks depending on the amount of information available. All it takes is a couple of clicks.
+[API monitoring](/learn/monitoring/api-monitoring) is key to ensure that our endpoints are returning the correct results in an acceptable timeframe.  If we can generate APIs from a OAS description file, we can also generate monitoring checks for them. Checkly is [a member of the OpenAPI initiative](https://www.openapis.org/about), and allows us to import an OpenAPI spec file and automatically creates one or more checks depending on the amount of information available. All it takes is a couple of clicks.
 
 When creating an API check, select the `import from Swagger / OpenAPI` button.
 

guides/monitoring-ecommerce-apps-using-playwright.mdx

@@ -44,7 +44,7 @@ Watch our launch event to learn more about our CLI:
 Users who have already used Checkly will be familiar with creating Checks, Check Groups, Alert Channels and other resources through the Checkly UI. Creating, debugging and managing E2E and synthetic monitoring at scale is best done “as code”. Currently, Checkly supports three tools you can use for your monitoring as code (MaC) workflow:
 
 1. [The Checkly CLI.](https://www.checklyhq.com/cli/overview)
-2. [Terraform (through our Terraform provider)](https://checklyhq-com-git-cli-guide-checkly.vercel.app/docs/terraform-provider/)
+2. [Terraform (through our Terraform provider)](/integrations/iac/terraform/overview)
 3. [Pulumi (through our Pulumi provider)](https://www.checklyhq.com/docs/integrations/pulumi/)
 
 ## Monitoring an e-commerce website - as code

guides/moving-from-puppeteer-to-playwright.mdx

@@ -48,7 +48,7 @@ Remember to add `await` as necessary.
 | `page.waitForXPath(XPathSelector)`          | `page.waitForSelector(XPathSelector)`            |
 | `page.$x(xpath_selector)`                   | `page.$(xpath_selector)`                         |
 | `page.waitForNetworkIdle(...)`              | `page.waitForLoadState({ state: 'networkidle' })` |
-| `page.waitForFileChooser(...)`              | Removed, [handled differently](https://playwright.dev/docs/input/#upload-files). |
+| `page.waitForFileChooser(...)`              | Removed, [handled differently](https://playwright.dev/docs/input#upload-files). |
 | `page.waitFor(timeout)`                     | `page.waitForTimeout(timeout)` |
 | `page.type(selector, text)`                 | `page.fill(selector, text)` |
 | `page.cookies([...urls])`                   | `browserContext.cookies([urls])` |
@@ -235,7 +235,7 @@ await page.route('**/*', (route) => {
 
 See our [full guide](/learn/playwright/intercept-requests) on request interception for more examples.
 
-> For many of the points in the list above, variations of the same function exist at [Page](https://playwright.dev/docs/api/class-page/), [Frame](https://playwright.dev/docs/api/class-frame/) and [ElementHandle](https://playwright.dev/docs/api/class-elementhandle/) level. For simplicity, we reported only one.
+> For many of the points in the list above, variations of the same function exist at [Page](https://playwright.dev/docs/api/class-page), [Frame](https://playwright.dev/docs/api/class-frame) and [ElementHandle](https://playwright.dev/docs/api/class-elementhandle) level. For simplicity, we reported only one.
 
 ## New possibilities to be aware of