added examples to methods