renamed for clarity and added examples to README