[WIP] Add documentation for how the balanced sampler works

[Copilot]

• Understand existing sampler implementation and relevant documentation
• Add clear documentation explaining how the balanced sampler works and how to enable it
• Run/verify any relevant tests or sanity checks (if applicable)

---

📍 Connect Copilot coding agent with Jira, Azure Boards or Linear to delegate work to Copilot in one click without leaving your project management tool.