@pascal, when you have time it would be great to have some documentation, instructions, or guidance about how the swagger rest documentation generator works.
Even the smallest amount would be helpful as a starting point.
I’m personally interested in two things:
- If I find a mistake in the docs, is there something I can easily do to fix it (without much time investment, while doing something else)
- Are there general guidelines we should follow in our resources that make them more documentable? E.g. if we automatically document @SearchHandlers, but can’t document behavior of the search method, should we start refactoring our code guided by that? Or would we just need to but some textual annotation on the search method to document how it works?