First of all, it is really convenient to generate api documents in this way, there is really no pain. But there are some limitations.
For example, API description, param description cannot be customized.
If you can continue to edit the api description and parameter description in the generated html file, then this tool can be safely used in many project
some idea:
- Integration with other online document editing services
- Adapt the generated data to tools such as swagger or apidoc