Extend Considered Alternatives with example code

[slightlyoff]

It would be helpful in weighing up this design to see how the various approaches listed in the considered alternatives section work in practice. Not having sample code to compare to makes it difficult to understand why this design is superior.

[noamr]

Point taken, will expand that!