--added more detail to design and updated data formats and also actions
--updated the configuration to match the documentation