kommentaar
kommentaar copied to clipboard
Teamwork
Generate documentation for Go APIs
Additional information may be useful (we have some use cases) in the description of the `Responses`. I have some preliminary work in a fork on this where I changed the...
Right now `enums` are declared via comments, but it would be nice to attempt to retrieve them automatically, with a fallback to comment-based enums if the comments are already specified....
In the latest fix, looks like we introduced a small bug. Even that now all references are correct, one of the data definitions is not generated. Here is the diff...
``` /* GET /v1/test tests Response 200: $ref: bool */ ``` throws `could not parse response 200 params: GetReference: could not find type "bool" in package ...` then tried: ```...
Right now all the godoc comments for references are added to the Kommentaar output. Sometimes it might be useful to have just some internal/private notes. I can't really think of...
Bit of a testbed for new features. It's kind of a mess, and could do with some cleaning.