added some more documentation for friendship api