Skip to content

docs(recipes): add Recipes section batch 1 (upload, download PDF, iframes, Shadow DOM) - #18

Merged
shossain786 merged 1 commit into
masterfrom
docs/recipes-batch-1
Jul 14, 2026
Merged

shossain786 merged 1 commit into
masterfrom
docs/recipes-batch-1

Conversation

@shossain786

Copy link
Copy Markdown
Contributor

Closes #6

What

Adds a task-titled Recipes section under docs-site/docs/recipes/ — batch 1. These match how people actually Google ("selenium upload file") rather than by framework concept, closing the gap the issue flags.

Each recipe is short — a focused, copy-pasteable snippet plus a link into its deeper guide, not a duplicate of the guide (avoids splitting SEO authority):

Recipe API Links to
Upload a file BasePage.upload(By, path) BasePage guide
Download & verify a PDF DownloadManager.waitForAnyFile / waitForFile DownloadManager guide
Handle iframes BasePage.withinFrame(...) (auto-restores context, nestable) BasePage guide
Handle Shadow DOM shadowFind / shadowClick / shadowType / shadowPierce BasePage guide

Notes

  • Snippets are written idiomatically: the upload/iframe/shadow helpers are BasePage methods, so those recipes use a page object; DownloadManager is static, so that one runs in a @Test. All verified against the source.
  • New Recipes sidebar category, placed after the guides cluster.

Acceptance criteria

  • 4 recipe pages, each with description: frontmatter and a task-shaped title
  • Each links to its underlying guide
  • Added to the sidebar; npm run build passes

🤖 Generated with Claude Code

…ames, Shadow DOM)

Closes #6

Task-titled, copy-pasteable recipe pages under docs/recipes/, matching how
people actually search ("selenium upload file") rather than by framework
concept. Each is short and links into its underlying guide instead of
duplicating it (keeps SEO authority consolidated):

- Upload a file            -> BasePage.upload(By, path)      -> base-page guide
- Download & verify a PDF  -> DownloadManager.waitForAnyFile -> download-manager guide
- Handle iframes           -> BasePage.withinFrame           -> base-page guide
- Handle Shadow DOM        -> shadowFind/Click/Type/Pierce   -> base-page guide

New "Recipes" sidebar category. All snippets verified against the real API
(helpers live on BasePage; DownloadManager is static). SEO description
frontmatter on all four. Build passes.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@shossain786
shossain786 merged commit a07e1f0 into master Jul 14, 2026
2 checks passed
@shossain786
shossain786 deleted the docs/recipes-batch-1 branch July 14, 2026 06:04
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.

Docs: add a Recipes section (batch 1 — upload, download PDF, iframes, Shadow DOM)

1 participant