Skip to content
This repository was archived by the owner on Jan 5, 2026. It is now read-only.

Update Multistep check overview page#1271

Merged
guolau merged 7 commits into
mainfrom
guolau/update-multistep-check-overview-page
May 12, 2025
Merged

Update Multistep check overview page#1271
guolau merged 7 commits into
mainfrom
guolau/update-multistep-check-overview-page

Conversation

@guolau
Copy link
Copy Markdown
Contributor

@guolau guolau commented Apr 29, 2025

Affected Components

  • Content & Marketing
  • Pricing
  • Test
  • Docs
  • Learn
  • Other

Pre-Requisites

  • Code is linted (npm run lint)

Notes for the Reviewer

Updated the Multistep check overview page according to the check overview page facelift proposal.

Includes minor changes to /docs/monitoring/check-results/#multistep-check-results.

@guolau guolau requested a review from ragog April 29, 2025 22:31
@guolau guolau requested a review from tnolet as a code owner April 29, 2025 22:31
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 29, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
checklyhq-com ✅ Ready (Inspect) Visit Preview 💬 Add feedback May 12, 2025 6:05pm

@Dgiordano33
Copy link
Copy Markdown
Collaborator

Same comment here @guolau - the image at the top is jarring because of the size and how much it takes up in the window. Should have to scroll slightly, or just have more text at the top.

@guolau
Copy link
Copy Markdown
Contributor Author

guolau commented May 5, 2025

Moved image further down page @Dgiordano33

I might just remove the intro image from all the check overview pages, they're all the same and I'm not sure how much they add.


Monitoring your API user flows instead of individual endpoints gives confidence that your product as a whole works as intended and that the expected interactions between API calls are functional.

![Multistep check overview page](/docs/images/multistep-api-checks/multistep-check-overview.png)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@guolau the check name in this screenshot can be confusing for users as it references multiple Checkly construct. Let's have these reference something not Checkly related, i.e. a realistic (sounding) API endpoint or its related feature.


Multistep checks are powered by `@playwright/test`'s [API Testing](https://playwright.dev/docs/api-testing) mode. Meaning you get all of the power of our typical API checks in the form of a programmable `@playwright/test` check.

> Multistep checks are only supported on runtime 2023.09 or later. See [Runtimes](/docs/runtimes/) for more details.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@guolau on the part just following, where it is said that

The following code is a valid Multistep check

Can we adjust this? What is shown is not a multistep check, but rather the PWT spec it is built on. I think it's important to make this clearer (also in the "Breaking down a multistep check" section) as right after we actually assume that distinction when talking about "Creating multistep checks"

> If the script fails, your check fails.

### Structuring a Multistep check
#### Structuring a Multistep check
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@guolau having this as h4 doesn't feel right, but this will be fixed when we go back and make the above h3s in the "Creating a Multistep check" section just a bullet point list or similar, as you already suggested.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added an action item to revisit this in the facelift wrap up task on the Support Board, so we don't lose it

Copy link
Copy Markdown
Contributor

@ragog ragog left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@guolau I spotted some needed changes, let's address those and keep moving.

Copy link
Copy Markdown
Contributor

@ragog ragog left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@guolau LGTM

@guolau guolau merged commit 2820877 into main May 12, 2025
6 checks passed
@guolau guolau deleted the guolau/update-multistep-check-overview-page branch May 12, 2025 18:52
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants