tried to fill in details for authentication
added explanation of users/self
fixed internal links to be relative