Я хотел бы построить webserver api с php и хочу сгенерировать публичную документацию для api endpoints с использованием doxygen.
Пока я знаю, как заставить doxygen использовать мою внутреннюю документацию кода, но я хотел бы создать вторую общедоступную документацию, которая описывает только конечные точки общедоступного веб-сервера.
Я бы хотелпоместить соответствующую документацию в мои контроллеры и действия так, чтобы любые изменения конечной точки могли обновляться одновременно при разработке вместо того, чтобы поддерживать код и документацию параллельно.Таким образом, в grenal мне нужен способ как-то пометить свои публичные документы и сделать их списком doxygen только для моей публичной документации.
Есть ли стандартный или лучший способ добиться этого?Какие необходимые шаги настройки?Есть ли какие-нибудь инструменты на основе кислорода, которые могут помочь?
Спасибо