updated docs for starting off with fixes