Добрый день. меня поприсли завести swagger на проекте. и вот такие штуки

приходиться писать

/**
* @SWG\Get(
* summary="Get data arrays.",
* description="Get string arrays for jobs, regions, areas, towns",
* tags={"Application form"},
* produces={"application/json"},
* @SWG\Response(
* response=200,
* description="successful operation",
* @SWG\Schema(
* type="object",
* @SWG\Property(
* property="jobs", type="array",
* @SWG\Items(type="string")
* ),
* @SWG\Property(
* property="regions", type="array",
* @SWG\Items(type="string")
* ),
* @SWG\Property(
* property="areas", type="array",
* @SWG\Items(type="string")
* ),
* @SWG\Property(
* property="towns", type="array",
* @SWG\Items(type="string")
* ),
* )
* )
* )
*
* @Rest\Get("/getDataArrays", name="getDataArrays")
*/
public function getDataArrays() { .... }

это нормально или лыжи все такие не едут?

это извращение, конф гурируй сваггер отдельно от кода