Make Me Want To Read Your Docs (mahdiyusuf.com)

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/