path updates and documentation