plaid-python icon indicating copy to clipboard operation
plaid-python copied to clipboard

No formal human-readable documentation for SDK exists.

Open iMakedonsky opened this issue 3 years ago • 1 comments

As stated in the title, currently the only way to read what this sdk wants to get for which param to which method is to go to implementation via IDE and read through boilerplate openapi code.

Boilerplate-generated errors rarely help understand where sdk wants an instance of an inner class, an array of such instances or just a string/array of strings. So you still have to go and check through the code.

iMakedonsky avatar Feb 06 '22 18:02 iMakedonsky

For reference here, this should work better if the client is regenerated using openapi v6.2.0 Docs for that generator include inline types or links to reference types Endpoints include type hints Model inputs include type hints

spacether avatar Sep 30 '22 18:09 spacether