first step of upgrading the documentation