docs: add guide on enforcing sales channel availability in cart + fix to references

[shahednasser]

1. Add guide on how to enfrce that a product matches the cart's sales channel
2. Add a note about throwing CONFLICT medusa errors: their message is overridden
3. Fix :::note parsing in references

Closes DX-2845 and DX-2850

[changeset-bot]

⚠️ No Changeset found

Latest commit: a4bece6

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	medusa-docs-cloud	a4bece6	Commit Preview URL Branch Preview URL	Jul 31 2026, 01:34 PM

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	medusa-docs-book	a4bece6	Commit Preview URL Branch Preview URL	Jul 31 2026, 01:37 PM

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	medusa-docs-ui	a4bece6	Commit Preview URL Branch Preview URL	Jul 31 2026, 01:32 PM

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	medusa-docs-user-guide	a4bece6	Commit Preview URL Branch Preview URL	Jul 31 2026, 01:38 PM

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	medusa-docs-api-reference	a4bece6	Commit Preview URL Branch Preview URL	Jul 31 2026, 01:33 PM

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	medusa-docs-resources	a4bece6	Commit Preview URL Branch Preview URL	Jul 31 2026, 01:41 PM