feat: add Troubleshooting for widget

[shoom3301]

Description

Solution of white iframe background color from one of the integrators.
More details: https://gist.github.com/jdanyow/9916d77f09089f8c6f7993438f8c292a

Summary by CodeRabbit

• Documentation
  • Added a Troubleshooting section addressing widget display issues where an iframe may show a white background; explains how a page-level color-scheme meta tag can affect the widget and advises removing or adjusting that meta tag to restore expected appearance.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
docs	Ready	Preview	Dec 22, 2025 9:18am

[coderabbitai]

Walkthrough

Added a Troubleshooting section to the widget tutorial documenting an iframe white background issue and advising removal of a conflicting <meta name="color-scheme"> tag when it causes the problem.

Changes

Cohort / File(s)	Summary
Documentation Update docs/cow-protocol/tutorials/widget/widget.md	Added a "Troubleshooting" section describing a white background appearance for the widget iframe and guidance to remove or adjust a <meta name="color-scheme"> tag if it causes the issue.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 I hopped into docs to say,
A tiny iframe lost its way.
Remove the meta, let colors play,
Now the widget’s bright and gay. ✨

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	❓ Inconclusive	The description provides context for the change but lacks the structured template with a detailed 'Changes' section listing the modifications made.	Add a 'Changes' section listing the specific updates made (e.g., Troubleshooting section added, meta tag guidance included) to match the repository template structure.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'feat: add Troubleshooting for widget' clearly describes the main change—adding a Troubleshooting section to the widget documentation.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/widget-troubleshouting

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 8853522 and 082c1f0.

📒 Files selected for processing (1)

• docs/cow-protocol/tutorials/widget/widget.md (1 hunks)

🧰 Additional context used

🪛 markdownlint-cli2 (0.18.1)

docs/cow-protocol/tutorials/widget/widget.md

600-600: Spaces inside code span elements

(MD038, no-space-in-code)

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (1)

docs/cow-protocol/tutorials/widget/widget.md (1)

596-600: Consider linking to the implementation details gist for better context.

The troubleshooting entry mentions a known issue and its solution clearly. However, the PR description references a detailed gist explaining the root cause and implementation context. Consider adding a link to help integrators understand the issue more deeply, especially if it relates to CSS cascade or browser behavior specifics that might inform their own solutions.

🔎 Proposed enhancement

 ### White background of the iframe
 
-1. If you use `<meta name="color-scheme">` in your HTML document, it might affect the widget iframe background color. Try to remove the meta tag in that case.
+1. If you use `<meta name="color-scheme">` in your HTML document, it might affect the widget iframe background color. Try to remove the meta tag in that case.
+
+   For implementation details, see [this gist](https://gist.github.com/jdanyow/9916d77f09089f8c6f7993438f8c292a).

📜 Review details

Configuration used: defaults

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 082c1f0 and a259b2d.

📒 Files selected for processing (1)

• docs/cow-protocol/tutorials/widget/widget.md

🔇 Additional comments (1)

docs/cow-protocol/tutorials/widget/widget.md (1)

596-600: Inline code formatting is now correct.

The markdown linting issue from the previous review has been resolved—the inline code is properly formatted without extra spaces inside the backticks.