fixed README and add debug_readme() method