openfga / sdk-generator

OpenFGA Client SDK Generator
Apache License 2.0
16 stars 43 forks source link

Java SDK: Javadocs need love #190

Open booniepepper opened 1 year ago

booniepepper commented 1 year ago

There are some artifacts from OpenAPI generator like HTML escapes (especially < and > for generic tags) that seem unnecessary.

Comes from https://github.com/openfga/java-sdk/pull/7/files#r1303460515 and https://github.com/openfga/sdk-generator/pull/189#discussion_r1303461467

Also there are some descriptions in unrendered markdown that are hard to read.

One example:

Screenshot 2023-08-23 at 12-40-53 OpenFgaApi (openfga-sdk 0 1 API)