fixing typo in devise name
adding new and better documentation
deprecating old doc and pointing to the new one`