updating docs and providing json file with sample data