Signing in now returns that users details

The signin function now returns that users account details upon
successful login. The documentation has also been updated to reflect
these changes.