Improve documentation/code accuracy regarding object structures
Timelessprod opened this issue · 1 comments
Problem trying to solve
When building an app on top of the Jira library I am often lost about what fields are available for comments or other objects. The Python class type for such object does not have explicit attributes in the library code and the documentation doesn't show the fields either.
This example for comments can be extended to other classes and is very slowing down the development using this library. Overall the current implementation of the library uses a lot of abstract classes when a way simpler implementation could be possible and that makes the code less readable and doesn't allow IDEs to autocomplete code and provide insights.
Possible solution(s)
Adjust the documentation with a list of all fields existing for all type of objects (Comments, issues, users, ...) and/or adjust implementation of object representation
Alternatives
No response
Additional Context
For example, from the documentation and source code themselves, how am I supposed to know the fields names and structures of a Jira comment ? This is the type of question that may come back every time someone is working with Jira.