Skip to content

Add a documentation_formats that differs from formats #1854

Closed
@jdeniau

Description

@jdeniau

If you de-activate the json format from the configuration, you can not use like ReDoc. You can not use the integrated swagger if you disable html format.

Personally, I disable everything except json-ld (less options means less bugs ;) ).

Furthermore, I don't think that enabling html format is really pertinent for an API, but it does for the documentation.

Do you think it's a good idea to split formats from the documentation_formats, this way, we could do something like:

api_platform:
    formats: 
        jsonld: ['application/ld+json']
    documentation_formats: 
        html: ['text/html']
        json: ['application/json']

As usual, I will open a PR if you agree with this.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions