Oh, for sure! Part of the nice thing about OpenAPI + the way I've started
implementing it is that it's partially self-documenting - the files that
generate the docs are the same ones that generate the actual code. A human
still has to add the descriptive text that the server doesn't need, but
they can't actually get totally unsync'd, and will always at least have
paths/methods/what it takes/what it gives back. The current XML-RPC API and
the docs that go with it, uh, leave a lot to be desired.
no subject
Oh, for sure! Part of the nice thing about OpenAPI + the way I've started implementing it is that it's partially self-documenting - the files that generate the docs are the same ones that generate the actual code. A human still has to add the descriptive text that the server doesn't need, but they can't actually get totally unsync'd, and will always at least have paths/methods/what it takes/what it gives back. The current XML-RPC API and the docs that go with it, uh, leave a lot to be desired.