telepathy: Documentation fixes

• Wire up the new classes to gtk-doc
• Use consistent naming for the provider_[name|type] parameter in
  goa_provider_factory_get_provider()
• Expand a bit on the provider_name meaning

https://bugzilla.gnome.org/show_bug.cgi?id=712535