Fix example code, clean up doc, and attempt to address customer feedback (dotnet#27189)

* Edit pass, and clean up before actually working the issue

* Clean up code

* Final clean up

* -gerunds

* Apply suggestions from code review

Co-authored-by: Tom Dykstra <tdykstra@microsoft.com>

Co-authored-by: Tom Dykstra <tdykstra@microsoft.com>

Author: IEvangelist