playbook and docs updates