User guide to msm with worked examples