completed methods, added general information and examples