added some example scenarios to help demonstrate the usage