Make Me Want To Read Your Docs

You forgot one thing ... leave the old documentation where people can easily find it, CakePHP does this well http://book.cakephp.org/ Rails? no so well http://guides.rubyonrails.org/