updated docs to current writing stage