nullable enums not properly described

[DjordyKoert]

Found in #2112 (comment)

Ah yup that would make more sense, that is also the way it is described to do it here https://swagger.io/docs/specification/data-models/enums/.
But I also think this is just a problem with the way enums are currently described as can be seen here:

NelmioApiDocBundle/PropertyDescriber/ObjectPropertyDescriber.php

Lines 40 to 46 in ed742a7

	if ($types[0]->isNullable()) {
	$weakContext = Util::createWeakContext($property->_context);
	$property->nullable = true;
	$property->oneOf = [new OA\Schema(['ref' => $this->modelRegistry->register(new Model($type, $groups)), '_context' => $weakContext])];
	return;
	}

Enum's should not be handled here, because they are quite simple schema's. I will go ahead and create a different issue for this.

[bnowak]

Hello, I've created draft PR connected to this topic. It seems that this PR fixed nullable enums for OAS 3.0, but unfortunately broke it for OAS 3.1.

@DjordyKoert could we re-open this issue to follow the topic for OAS 3.1 here?