Example code tutorials for `lib/substitutions`

[lockshaw]

Add some examples of how to use the library (with some testing/assertions to make sure they stay functioning over time) with either accompanying documentation (i.e., markdown) or inline-comments walking a new developer through some common use cases.