docs: add placement hint guidance

Merged
RE
2mo ago
+160-2

Placement hints are supported by the built-in placement directors for new activation placement and activation migration, but the grain placement guide did not show application code for selecting and targeting a silo.

Add a direct-placement and migration section with compiled examples that inject IClusterMembershipService and ILocalSiloDetails, select an active silo other than the caller, and use the hint when calling a grain that may need activation, invoking MigrateOnIdle, or passing a migration-specific dictionary directly to IGrainContext.Migrate. The guidance explains request-context capture and propagation, activation timing, membership snapshots, compatibility filtering, existing activations, preserving the caller's request-context value, and containing the inherited hint before a receiving grain makes unrelated outgoing calls.

Microsoft Reviewers: Open in CodeFlow