updated readme, docs and core submodule