updated docs to reflect recent changes and future release