OpenAPI

Выбор зависит от нескольких моментов, в т.ч. стоит учитывать:
размер вашего проекта, его архитектуру, командные соглашения и личные предпочтения.

На что именно стоит обратить внимание:

Required @OA\Info() not found
Required @OA\PathItem() not found

Добавьте в любой из php-файлов из той папки, которую вы обходите, что-то вроде:

/**
 * @OA\Info(title="My First API", version="0.1")
 */

/**
 * @OA\Get(
 *     path="/api/resource.json",
 *     @OA\Response(response="200", description="An example resource")
 * )
 */