update docs to reflect the recent re-factoring