docs: optional-deps guide

[danielleroux]

🆕 What is the new behavior?

• Migration steps for: feat(core): make collection dependencies optional peers ix#2767

👨‍💻 Help & support

[netlify]

✅ Deploy Preview for industrial-experience ready!

Name	Link
🔨 Latest commit	2b9eceb
🔍 Latest deploy log	https://app.netlify.com/projects/industrial-experience/deploys/6a9ac1d3509a210008b2f6ef
😎 Deploy Preview	https://deploy-preview-294--industrial-experience.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Team

Run ID: d7c72708-f377-43c8-b591-4c1e8ec59ebf

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

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.}

[flxlst09]

Reviewed the exact PR range against development; one substantive issue found.

[flxlst09]

Medium — installation commands omit a required peer dependency\n\nThe page says collection consumers must install all required packages, but this command (and the npm/Yarn equivalents below) omits the still-required @siemens/ix-icons peer dependency. Copying these commands—particularly with Yarn or peer auto-installation disabled—can leave collection consumers with an unresolved peer dependency and an incomplete installation. Please add @siemens/ix-icons to all three commands, or explicitly state that it remains a required existing dependency.