added some validation methods and updated the readme to explain this branch