Specs 1.1 and 1.2 lack a title for "Flow information" type

[DMRobertson]

Link to problem area: any request which may return user interactive auth flow information, e.g. here.

Issue: The description of a 401 response refers to a Flow information type. That type is described below, but without a <caption> making it hard to find.

Cause unclear, though I wonder if the space in Flow information is causing trouble.

[turt2live]

this would be the OpenAPI title missing for the type, I believe.

[DMRobertson]

AFAICS the title exists:

matrix-spec/data/api/client-server/definitions/auth_response.yaml

Lines 14 to 35 in 00c6a86

	title: Authentication response
	description: |-
	Used by servers to indicate that additional authentication information is required,
	type: object
	properties:
	flows:
	description: A list of the login flows supported by the server for this API.
	title: Flow information
	type: array
	items:
	type: object
	properties:
	stages:
	description: |-
	The login type of each of the stages required to complete this
	authentication flow
	type: array
	items:
	type: string
	example: "example.type.foo"
	required:
	- stages

[DMRobertson]

Adding {{ printf "%#v" .title }} just before this line, I see that .title is <nil> when generating the table for Flow information.

[DMRobertson]

Additional debugging: it looks like this call to get-additional-objects produces an additional object whose enum is nil.

matrix-spec/layouts/partials/json-schema/resolve-additional-types.html

Line 47 in 942f865

{{ $additional_objects = partial "get-additional-objects" (dict "this_object" $property "additional_objects" $additional_objects) }}

[DMRobertson]

Having dug through far too much hugo templating, I think I now see what the problem is: the title in the OpenAPI spec is misplaced.