Minor updates in comments for api/friends servlet

Updates to the documentation indicating the people connected to the user as opposed to the user themselves is returned from Friends.