Где разместить @SWG\Definition для повторного использования с Swagger-PHP и Nelmio API-DOC Bundle

Question

Я хотел бы написать где-нибудь @SWG\Definition и сослаться на него в аннотации @SWG\Schema в @SWG\Response для нескольких действий REST API в моем приложении Symfony 3. Я использую версию api-doc-bundle от Nelmio, но я могу найти что-нибудь, что подсказывает, куда должно идти это определение. Документы Swagger-PHP призывают не повторяться, если это возможно, и я хотел бы следовать этой рекомендации. Есть намеки?

Answer 1

Типичный... В конце концов сломайтесь и спросите, а затем выясните решение вскоре после...

Я обнаружил, что могу предварительно загрузить данные документации в app/config/config.yml Symfony.

nelmio_api_doc:
    documentation:
        definitios:
            Error: 
                type: object
                properties:
                    success:
                        type: boolean
                        example: false
                    error:
                        type: string
                        example: message

Теперь я могу использовать что-то подобное во всех моих действиях REST

/**
 *  @API\Operation(
 *     ...
 *     @SWG\Response(
 *         response="default",
 *         description="Failure",
 *         @SWG\Schema(ref="#definitions/Error")
 *     )
 * )
 */