blob: 6fb610dc3dacc643e9afa4051b0999b8478d4165 [file] [log] [blame]
<!DOCTYPE html>
<html lang="en">
<head>
<title>Apache Jena - Getting help with Jena</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="/css/bootstrap.min.css" rel="stylesheet" media="screen">
<link href="/css/bootstrap-icons.css" rel="stylesheet" media="screen">
<link href="/css/jena.css" rel="stylesheet" type="text/css">
<link rel="shortcut icon" href="/images/favicon.ico" />
</head>
<body>
<nav class="navbar navbar-expand-lg bg-body-tertiary" role="navigation">
<div class="container">
<div class="navbar-header">
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<a class="navbar-brand" href="/index.html">
<img class="logo-menu" src="/images/jena-logo/jena-logo-notext-small.png" alt="jena logo">Apache Jena</a>
</div>
<div class="collapse navbar-collapse" id="navbarNav">
<ul class="navbar-nav me-auto mb-2 mb-lg-0">
<li id="homepage" class="nav-item"><a class="nav-link" href="/index.html"><span class="bi-house"></span> Home</a></li>
<li id="download" class="nav-item"><a class="nav-link" href="/download/index.cgi"><span class="bi-download"></span> Download</a></li>
<li class="nav-item dropdown">
<a href="#" class="nav-link dropdown-toggle" role="button" data-bs-toggle="dropdown" aria-expanded="false"><span class="bi-journal"></span> Learn <b class="caret"></b></a>
<ul class="dropdown-menu">
<li class="dropdown-header">Tutorials</li>
<li><a class="dropdown-item" href="/tutorials/index.html">Overview</a></li>
<li><a class="dropdown-item" href="/documentation/fuseki2/index.html">Fuseki Triplestore</a></li>
<li><a class="dropdown-item" href="/documentation/notes/index.html">How-To's</a></li>
<li><a class="dropdown-item" href="/documentation/query/manipulating_sparql_using_arq.html">Manipulating SPARQL using ARQ</a></li>
<li><a class="dropdown-item" href="/tutorials/rdf_api.html">RDF core API tutorial</a></li>
<li><a class="dropdown-item" href="/tutorials/sparql.html">SPARQL tutorial</a></li>
<li><a class="dropdown-item" href="/tutorials/using_jena_with_eclipse.html">Using Jena with Eclipse</a></li>
<li class="dropdown-divider"></li>
<li class="dropdown-header">References</li>
<li><a class="dropdown-item" href="/documentation/index.html">Overview</a></li>
<li><a class="dropdown-item" href="/documentation/query/index.html">ARQ (SPARQL)</a></li>
<li><a class="dropdown-item" href="/documentation/assembler/index.html">Assembler</a></li>
<li><a class="dropdown-item" href="/documentation/tools/index.html">Command-line tools</a></li>
<li><a class="dropdown-item" href="/documentation/rdfs/">Data with RDFS Inferencing</a></li>
<li><a class="dropdown-item" href="/documentation/geosparql/index.html">GeoSPARQL</a></li>
<li><a class="dropdown-item" href="/documentation/inference/index.html">Inference API</a></li>
<li><a class="dropdown-item" href="/documentation/javadoc.html">Javadoc</a></li>
<li><a class="dropdown-item" href="/documentation/ontology/">Ontology API</a></li>
<li><a class="dropdown-item" href="/documentation/permissions/index.html">Permissions</a></li>
<li><a class="dropdown-item" href="/documentation/extras/querybuilder/index.html">Query Builder</a></li>
<li><a class="dropdown-item" href="/documentation/rdf/index.html">RDF API</a></li>
<li><a class="dropdown-item" href="/documentation/rdfconnection/">RDF Connection - SPARQL API</a></li>
<li><a class="dropdown-item" href="/documentation/io/">RDF I/O</a></li>
<li><a class="dropdown-item" href="/documentation/rdfstar/index.html">RDF-star</a></li>
<li><a class="dropdown-item" href="/documentation/shacl/index.html">SHACL</a></li>
<li><a class="dropdown-item" href="/documentation/shex/index.html">ShEx</a></li>
<li><a class="dropdown-item" href="/documentation/jdbc/index.html">SPARQL over JDBC</a></li>
<li><a class="dropdown-item" href="/documentation/tdb/index.html">TDB</a></li>
<li><a class="dropdown-item" href="/documentation/tdb2/index.html">TDB2</a></li>
<li><a class="dropdown-item" href="/documentation/query/text-query.html">Text Search</a></li>
</ul>
</li>
<li class="nav-item dropdown">
<a href="#" class="nav-link dropdown-toggle" role="button" data-bs-toggle="dropdown" aria-expanded="false"><span class="bi-journal-code"></span> Javadoc <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="/documentation/javadoc.html">All Javadoc</a></li>
<li><a class="dropdown-item" href="/documentation/javadoc/arq/">ARQ</a></li>
<li><a class="dropdown-item" href="/documentation/javadoc/fuseki2/">Fuseki</a></li>
<li><a class="dropdown-item" href="/documentation/javadoc/geosparql/">GeoSPARQL</a></li>
<li><a class="dropdown-item" href="/documentation/javadoc/jdbc/">JDBC</a></li>
<li><a class="dropdown-item" href="/documentation/javadoc/jena/">Jena Core</a></li>
<li><a class="dropdown-item" href="/documentation/javadoc/permissions/">Permissions</a></li>
<li><a class="dropdown-item" href="/documentation/javadoc/extras/querybuilder/">Query Builder</a></li>
<li><a class="dropdown-item" href="/documentation/javadoc/shacl/">SHACL</a></li>
<li><a class="dropdown-item" href="/documentation/javadoc/tdb/">TDB</a></li>
<li><a class="dropdown-item" href="/documentation/javadoc/text/">Text Search</a></li>
</ul>
</li>
</ul>
<ul class="navbar-nav ms-auto">
<li id="ask" class="nav-item"><a class="nav-link" href="/help_and_support/index.html"><span class="bi-patch-question"></span> Ask</a></li>
<li class="nav-item dropdown">
<a href="#" class="nav-link dropdown-toggle" role="button" data-bs-toggle="dropdown" aria-expanded="false"><span class="bi-megaphone"></span> Get involved <b class="caret"></b></a>
<ul class="dropdown-menu">
<li><a class="dropdown-item" href="/getting_involved/index.html">Contribute</a></li>
<li><a class="dropdown-item" href="/help_and_support/bugs_and_suggestions.html">Report a bug</a></li>
<li class="dropdown-divider"></li>
<li class="dropdown-header">Project</li>
<li><a class="dropdown-item" href="/about_jena/about.html">About Jena</a></li>
<li><a class="dropdown-item" href="/about_jena/architecture.html">Architecture</a></li>
<li><a class="dropdown-item" href="/about_jena/citing.html">Citing</a></li>
<li><a class="dropdown-item" href="/about_jena/team.html">Project team</a></li>
<li><a class="dropdown-item" href="/about_jena/contributions.html">Related projects</a></li>
<li><a class="dropdown-item" href="/about_jena/roadmap.html">Roadmap</a></li>
<li><a class="dropdown-item" href="/about_jena/security-advisories.html">Security Advisories</a></li>
<li class="dropdown-divider"></li>
<li class="dropdown-header">ASF</li>
<li><a class="dropdown-item" href="https://www.apache.org/">Apache Software Foundation</a></li>
<li><a class="dropdown-item" href="https://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a></li>
<li><a class="dropdown-item" href="https://www.apache.org/licenses/LICENSE-2.0">License</a></li>
<li><a class="dropdown-item" href="https://www.apache.org/security/">Security</a></li>
<li><a class="dropdown-item" href="https://www.apache.org/foundation/thanks.html">Thanks</a></li>
</ul>
</li>
<li class="nav-item" id="edit"><a class="nav-link" href="https://github.com/apache/jena-site/edit/main/source/help_and_support/__index.md" title="Edit this page on GitHub"><span class="bi-pencil-square"></span> Edit this page</a></li>
</ul>
</div>
</div>
</nav>
<div class="container">
<div class="row">
<div class="col-md-12">
<div id="breadcrumbs">
<ol class="breadcrumb mt-4 p-2 bg-body-tertiary">
<li class="breadcrumb-item active">HELP AND SUPPORT</li>
</ol>
</div>
<h1 class="title">Getting help with Jena</h1>
<p>We are always happy to help you get your Jena project going. Jena has been around
for many years, there are many archives of past questions, tutorials and articles
on the web. A quick search may well answer your question directly! If not, please
feel free to post a question to the user support list (details below).</p>
<h2 id="email-support-lists">Email support lists</h2>
<p>The <em>main user support list</em> is <code>users@jena.apache.org</code>. To join this
list, please send an email to: <a href="mailto:users-subscribe@jena.apache.org">
<code>users-subscribe@jena.apache.org</code></a> from the email account you want
to subscribe with. This list is a good place to ask for advice on developing Jena-based
applications, or solving a problem with using Jena. <em>Please see below for notes
on asking good questions</em>. The list is archived at
<a href="https://lists.apache.org/list.html?users@jena.apache.org">lists.apache.org</a>
or externally at <a href="https://jena.markmail.org/search/">jena.markmail.org</a></p>
<p>The <em>developers</em> list is <code>dev@jena.apache.org</code>. To join this
list, please send an email to: <a href="mailto:dev-subscribe@jena.apache.org">
<code>dev-subscribe@jena.apache.org</code></a> from the email account you want
to subscribe with. This list is a good place to discuss the development of the Jena
platform itself, including patches you want to submit.</p>
<p>To unsubscribe from a mailing list, send email to <code>LIST-unsubscribe@jena.apache.org</code>.</p>
<p>Full details of Apache mailing lists: <a href="https://www.apache.org/foundation/mailinglists.html">https://www.apache.org/foundation/mailinglists.html</a>.</p>
<h2 id="other-resources">Other resources</h2>
<p>There are curated collections of Jena questions on StackOverflow
<a href="https://stackoverflow.com/questions/tagged/jena">tagged &lsquo;jena&rsquo;</a> and
<a href="https://stackoverflow.com/questions/tagged/apache-jena">&lsquo;apache-jena&rsquo;</a>.
There are also <a href="https://stackoverflow.com/questions/tagged/sparql">questions and answers about SPARQL</a>.</p>
<h2 id="how-to-ask-a-good-question">How to ask a good question</h2>
<p>Asking good questions is <strong>the best way to get good answers</strong>. Try to follow these tips:</p>
<ul>
<li>
<p>Make the question <strong>precise</strong> and <strong>specific</strong>. <em>&ldquo;My code doesn&rsquo;t work&rdquo;</em>, for example, does not help us to help you
as much as <em>&ldquo;The following SPARQL query gave me an answer I didn&rsquo;t expect&rdquo;</em>.</p>
</li>
<li>
<p>Show that you&rsquo;ve <strong>tried to solve the problem yourself</strong>. Everyone who answers questions on the list
has a full-time job or study to do; no-one gets paid for answering these support questions. Spend
their goodwill wisely: <em>&ldquo;Here&rsquo;s the code I tried&hellip;&quot;</em> or <em>&ldquo;I read in the documentation that &hellip;&quot;</em> shows that
you&rsquo;ve at least made some effort to find things out for yourself.</p>
</li>
<li>
<p>Where appropriate <strong>show a complete test case</strong>. Seeing where your code goes wrong is generally
much easier if we can run it our computers. Corollaries: <strong>don&rsquo;t post your entire project</strong> - take some
time to reduce it down to a minimal test case. <strong>Include enough data</strong> - runnable code is no help if
critical resources like <code>*.rdf</code> files are missing. Reducing your code down to a minimal test case
is often enough for you to figure out the problem yourself, which is always satisfying!</p>
</li>
<li>
<p><strong>Don&rsquo;t re-post your question</strong> after only a few hours. People are busy, and may be in a different timezone
to you. If you&rsquo;re not sure if your question made it to the list, <a href="https://markmail.org/search/?q=list:org.apache.jena.*">look in the archive</a>.</p>
</li>
<li>
<p><strong>Adding lots of exclamation marks</strong> or other punctuation will <strong>not</strong> move your question up the queue. Quite the
reverse, in fact.</p>
</li>
<li>
<p>Ask questions <strong>on the list, rather than emailing the developers directly</strong>. This gives us the chance to share the
load of answering questions, and also ensures that answers are archived in case they&rsquo;re of use to others in the future.</p>
</li>
</ul>
</div>
</div>
</div>
<footer class="bd-footer py-4 py-md-5 mt-4 mt-lg-5 bg-body-tertiary">
<div class="container" style="font-size:80%" >
<p>
Copyright &copy; 2011&ndash;2023 The Apache Software Foundation, Licensed under the
<a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
</p>
<p>
Apache Jena, Jena, the Apache Jena project logo, Apache and the Apache feather logos are trademarks of
The Apache Software Foundation.
<br/>
<a href="https://privacy.apache.org/policies/privacy-policy-public.html"
>Apache Software Foundation Privacy Policy</a>.
</p>
</div>
</footer>
<script src="/js/popper.min.js.js" type="text/javascript"></script>
<script src="/js/bootstrap.min.js" type="text/javascript"></script>
<script src="/js/improve.js" type="text/javascript"></script>
<script type="text/javascript">
const link = document.querySelector(`a[href="${window.location.pathname}"]`);
if (link !== undefined && link !== null) {
const parents = link.parentElement
for (const parent of parents) {
if (parent.tagName === 'ul' || parent.tagName === 'li') {
parent.style += 'active';
}
}
}
</script>
</body>
</html>