Page MenuHomePhabricator

rest.php only exposes $wgEmergencyContact as contact
Open, Needs TriagePublic

Description

While testing T362006: Provide a Swagger-UI for exploring the core REST API...

https://spec.openapis.org/oas/v3.0.0.html#contact-object

{
  "name": "API Support",
  "url": "http://www.example.com/support",
  "email": "support@example.com"
}

But we only expose $wgEmergencyContact:

	private function getContactSpec(): array {
		return [
			'email' => $this->options->get( MainConfigNames::EmergencyContact ),
		];
	}

We should probably expose a better "name" (as it's not necessarily the "developer" as is shown to be exposed on the implementation of T362006 using the swagger-ui).

Should we label $wgEmergencyContact as something like "Site Administrator"?

Should we be exposing $wgEmergencyContact at all in this way?

https://www.mediawiki.org/wiki/Manual:$wgEmergencyContact calls it the "Site admin email address", and then documents it further as:

This allows the site administrator to specify an email address that the wiki can contact if something goes wrong. Current versions of MediaWiki (1.13 and above) do not use this setting, having delegated its uses to $wgPasswordSender, but future versions or extensions might.

Can we expose also "MediaWiki" developers in some way?