@ApiSubresource route overriding other collection routes with same path

I’ve noticed that if you add a collectionOperations that uses the same path as an existing @ApiSubresource, then the route operation is missing from the generated Swagger docs.

I’ve found the workaround is to re-name the {id} parameter to something else, that does not clash with the @ApiSubresource path, but this took some working out. It looks like the \ApiPlatform\Core\Swagger\Serializer\DocumentationNormalizer::normalize() method does not combine the routes together, but instead allows the @ApiSubresource version to overwrite the other routes.

I think that \ApiPlatform\Core\Swagger\Serializer\DocumentationNormalizer::normalize() (or it’s dependencies) could do with updating to combine not overwrite the route docs.

[soyuka]

Should be moved to the api-platform/core repository

[toby-griffiths]

Thank you @soyuka