final changes and docs