Core: Nelmio api doc integration throws an error

[alfabetagama]

api_platform:
    enable_nelmio_api_doc: true

Throws an error:

The service "api_platform.nelmio_api_doc.annotations_provider" has a dependency on a non-existent service "api_platform.hydra.normalizer.documentation".

[meyerbaptiste]

You have to enable the jsonld format:

```yaml
api_platform:
# ...
formats:
# ...
jsonld: ['application/ld+json']

[alfabetagama]

@meyerbaptiste thanks.

[Nek-]

Hello,

I use the following:

api_platform:
    enable_nelmio_api_doc: true
    formats:
        json:
            mime_types: ['application/json']

It looks like the fact of enabling nelmio API imply that this is wrong because there is no jsonld format specified. Why do I need to enable jsonld format? o_O

It looks like a real issue to me.

[Simperfit]

It is because we are giving an array to nelmio which is based on the hydra documentation.

The hydra document depend on jsonld, this is why you need to enable jsonld.

[Nek-]

I get why it fails. But I'm trying to highlight that it's not related. (well should not be related)

And there is no documentation saying it is. (which would make no sense)

[soyuka]

it is because the hydra documentation is using the jsonld format

[dunglas]

We may register required services without enabling the format. But IMO it's a waste of time. Our Swagger support is far better than our NelmioApiDoc support. And NelmioApiDoc has no added value compared to Swagger + Swagger UI. I think we should deprecate the NelmioApiDoc integration and promote only Swagger.

Le 31 juil. 2017 à 07:10, Antoine Bluchet [e-mail] a écrit :

it is because the hydra documentation is using the jsonld format

—
You are receiving this because you are subscribed to this thread.
Reply to this email directly, view it on GitHub, or mute the thread.

[Nek-]

💯
@dunglas please reopen the issue !