updated README and overview with examples and a description of the new breakable features