Document typical use cases

[yupferris]

Beyond basic examples, it would be useful to have docs that describe intended usage (eg. generating rust code in a build.rs script and using rust tests to unit-test the resulting sim code).