Home
Help
Search
Login
Register
OPNsense Forum
»
English Forums
»
Development and Code Review
(Moderator:
fabian
) »
Contributing OpenAPI documentation?
« previous
next »
Print
Pages: [
1
]
Author
Topic: Contributing OpenAPI documentation? (Read 1653 times)
studiop
Newbie
Posts: 1
Karma: 0
Contributing OpenAPI documentation?
«
on:
July 11, 2023, 02:51:20 am »
Hi all,
I didn't want to make an issue on Github since this more of a discussion. I see there have been some past efforts in creating API clients and documenting endpoints
here
and
here
which gave rise to the
current script
that is used to generate the API documentation. I have also come across various other clients (Python), and plugins for IaC tools such as Ansible and Terraform, that all have their own shortcomings due to having to manually implement an API client.
I would love to see better integration with OPNsense in these areas, and I would be interested in adding more "proper" documentation server-side using OpenAPI annotations with a library like
swagger-php
. This would unlock the ability to easily create clients and integrations through the OpenAPI generator, and would remove the need to parse the PHP code to render the docs.
The real question is would the developers be open to such contributions?
Logged
Print
Pages: [
1
]
« previous
next »
OPNsense Forum
»
English Forums
»
Development and Code Review
(Moderator:
fabian
) »
Contributing OpenAPI documentation?