[jira] [Commented] (JENA-1755) Improve documentation of Query Builders

["ASF subversion and git services (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/JENA-1755?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17000872#comment-17000872 ] 

ASF subversion and git services commented on JENA-1755:
-------------------------------------------------------

Commit 1871856 from Claude Warren in branch 'site/trunk'
[ https://svn.apache.org/r1871856 ]

Updated documentation as part of JENA-1755

> Improve documentation of Query Builders
> ---------------------------------------
>
>                 Key: JENA-1755
>                 URL: https://issues.apache.org/jira/browse/JENA-1755
>             Project: Apache Jena
>          Issue Type: Improvement
>            Reporter: Jan Martin Keil
>            Priority: Major
>          Time Spent: 1h
>  Remaining Estimate: 0h
>
> As discussed in JENA-1751, I propose to improve the documentation of the query builders:
> {quote}Unfortunately, I did not find (and I think there isn't) any documentation or tutorial about the query builders explaining more than the very basics. Also the JavaDoc (which is to the best of my knowledge nowhere linked on [https://jena.apache.org/]), is, in my experience, not helpful and makes it often necessary to look into the code to understand what is needed and maybe find out how to get it. If I did not miss a comprehensive documentation somewhere, I think it would be worth, to improve documentation. Even a few words at the builder classes (mentioning e.g. ExprFactory) and small examples at the more complicated methods would help a lot.
> {quote}



--
This message was sent by Atlassian Jira
(v8.3.4#803005)