update documentation and work in progress on cloud update