renamed readme to markdown filename, updated friends spec to be more user friendly