Skip to content

[Experimental]: Documentation Testing with Playwright #923

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 5 commits into from

Conversation

blindaa121
Copy link
Collaborator

Description

This PR introduces a comprehensive testing framework with Playwright for our API documentation, allowing us to automatically verify that all API documentation pages load correctly across our product ecosystem.

Motivation and Context

  • Early Detection: Catch broken API documentation before it reaches production
  • Complete Coverage: Test across all product categories
  • Efficient Testing: Sample-based approach keeps test runs manageable
  • Clear Reporting: Issues are reported by product category for easier debugging

How Has This Been Tested?

Note: Ensure local environment is running prior to the following steps

Step 1: Generate MDX Paths

First, run the collection script to scan all MDX files and generate the necessary paths:

node scripts/collect-mdx-paths.js

This will:

  • Scan the products/ directory for all MDX files
  • Create individual product test files in tests/products/ directory

Step 2: Run Playwright Tests

Once the test files are generated, run the Playwright tests:

yarn playwright test

or

yarn playwright test --ui (provides an intuitive testing experience)

Screenshots (if appropriate)

image

Playwright UI Testing Environment

Screenshot 2025-05-29 at 4 59 55 PM

Types of changes

  • New feature (non-breaking change which adds functionality)

Checklist

  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING document.
  • I have added tests to cover my changes if appropriate.
  • All new and existing tests passed.

@blindaa121 blindaa121 requested a review from a team as a code owner May 30, 2025 00:01
Copy link

Visit the preview URL for this PR (updated for commit 306f88c):

https://pan-dev-f1b58--pr923-7a6y23lp.web.app

(expires Sun, 29 Jun 2025 00:48:08 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: 9359a9fa100d5fdb082f75280473a90b1f96eb51

@blindaa121 blindaa121 closed this Jul 17, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant