Improve JavaDoc

Data Services Query API
,
1

Currently, I find a lot of Query API related JavaDoc to be lacking.
How can I best give feedback or contribute?
Complaining about each individual occurrence here feels like it could be annoying.

This is just one example: JavaDoc of QueryService#query():

grafik

What is T here? Syntax-wise I could assign the result to anything I like (say a QueryPage<BigDecimal>:wink: )
The text talks about a “page of document tree results”, so probably T is DocumentTreeResult.
But why is it generic, then. In which cases will it return which type?

2

Hi again,

Thanks for reporting it. We appreciate the feedback especially about QueryAPI and documentation a lot.

I would say:
If you have question, you can ask here. Always.
If you face the issue in the code or in documentation, please report A12 bug. If you see more issues in docs at once. Please combine them in one bug.

Thanks,

Josef

3

And one more thing. There is as well possibility to Give feedback directly in docs.geta12.com, so you can of course use that option,

Josef