Add sample or clarification for cross-platform behavior of [feature/area]

[2400031832]

Type of issue

Documentation / sample improvement

Description

Certain APIs or runtime behaviors behave differently across operating systems (e.g. Linux vs Windows) — for example, timezone conversions, file path handling, or native library interop.
I suggest adding a documentation section or sample code that demonstrates cross-platform usage and outlines caveats.

This helps developers avoid subtle bugs when targeting multiple OSes.

Suggested improvement

• Add a “Cross-platform considerations” section under relevant API docs.
• Provide small code samples showing recommended usage patterns.
• Document any known platform differences or limitations.

Why this helps

It improves clarity for application authors targeting Linux, macOS, Windows — reduces platform-specific bugs and support burden.

[baronfel]

Suggestions for the runtime or libraries should go to dotnet/runtime, but they need to be much more specific and detailed than this.