eclipse-rdf4j/rdf4j#2235 first draft of release notes for 3.3.0 (#161)

* eclipse-rdf4j/rdf4j#2235 first draft of release notes for 3.3.0

Detailed to be added as they become available.

* sh:inversePath support

Signed-off-by: Håvard Ottestad <hmottestad@gmail.com>

* GH-2235 added note on jackson dependencies

Signed-off-by: Bart Hanssens <bart.hanssens@bosa.fgov.be>

* GH-2235 added names

Signed-off-by: Bart Hanssens <bart.hanssens@bosa.fgov.be>

* GH-2235 added more names

Signed-off-by: Bart Hanssens <bart.hanssens@bosa.fgov.be>

* GH-2235 correction in name

Signed-off-by: Bart Hanssens <bart.hanssens@bosa.fgov.be>

* eclipse-rdf4j/rdf4j#2235 added pavel to acknowledgments

* GH-2235 added ack for elad shaked

* eclipse-rdf4j/rdf4j#2235 added a few highlight bullet points

* more updates for release

Signed-off-by: Håvard Ottestad <hmottestad@gmail.com>

* updated java docs

Signed-off-by: Håvard Ottestad <hmottestad@gmail.com>

* more 3.3.0 release notes, a news article and also more shacl documentation

Signed-off-by: Håvard Ottestad <hmottestad@gmail.com>

Co-authored-by: Håvard Ottestad <hmottestad@gmail.com>
Co-authored-by: Bart Hanssens <bart.hanssens@bosa.fgov.be>

site/content/documentation/programming/repository.md

@@ -1094,7 +1094,7 @@ public class QueryExplainExample {
 				"  BIND(<http://example.com/peter> as ?person)",
 				"	?person a foaf:Person .",
 				"	{",
-				"  		BIND(<http://example.com/peter> as ?person)",
+				"  	BIND(<http://example.com/peter> as ?person)",
 				"		?person	(foaf:knows | ^foaf:knows)* ?friend.",
 				"	} UNION {",
 				"		?friend foaf:age ?age",

site/content/documentation/programming/shacl.md

@@ -113,6 +113,14 @@ As of writing this documentation the following features are supported.
 - `sh:maxInclusive`
 - `sh:in`
 - `sh:deactivated`
+- `sh:hasValue`
+- `dash:hasValueIn`
+- `sh:target` for use with DASH targets
+- `rsx:targetShape`
+
+DASH and RSX features need to be explicitly enabled, for instance with `setDashDataShapes(true)` and 
+`setEclipseRdf4jShaclExtensions(true)`. These are currently experimental features. For more information 
+about the RSX features, see the RSX section of this document.
 
 Implicit `sh:targetClass` is supported for nodes that are `rdfs:Class` and either of `sh:PropertyShape` or `sh:NodeShape`. Validation for all nodes, 
 equivalent to `owl:Thing` or `rdfs:Resource` in an environment with a reasoner, can be enabled by setting `setUndefinedTargetValidatesAllSubjects(true)`.
@@ -303,6 +311,16 @@ sailRepository.shutDown();
 By default the ShaclSail supports the simple rdfs:subClassOf reasoning required by the W3C recommendation. There is no
 support for `sh:entailment`, however the entire reasoner can be disabled with `setRdfsSubClassReasoning(false)`.
 
+# RSX - Eclipse RDF4J SHACL Extensions
+RDF4J has seen a need to develop its own extension the W3C SHACL Recommendation in order to support new
+and innovative features. We always strive to collaborate with the community when developing these features.
+
+RSX currently contains `rsx:targetShape` which will allow a Shape to be the target for your constraints. This means 
+that it will be possible to model more complex use-cases like "all norwegian companies with 10 or more employees, 
+a revenue greater than or equal to 6 million NOK or valued at 23 million or above are required to have a registered 
+accountant". This also allows for considerably faster implementations than what is currently possible with SPARQL Targets.
+
+The RSX specification will be published soon together with the limited support for `rsx:targetShape` in 3.3.0 (`sh:or`, `sh:and`, `sh:hasValue`, `dash:hasValueIn`, `sh:path`, `sh:property`). 
 
 # Logging and debugging
 

site/content/download.md

@@ -5,29 +5,18 @@ toc: true
 
 You can either retrieve RDF4J via Apache Maven, or download the SDK or onejar directly.
 
-# RDF4J 3.2.3 (latest)
+# RDF4J 3.3.0 (latest)
 
-RDF4J 3.2.3 is our latest stable release. It requires Java 8. For details on what’s new and how to upgrade, see the [release and upgrade notes](/release-notes/3.2.3).
+RDF4J 3.3.0 is our latest stable release. It requires Java 8. For details on what’s new and how to upgrade, see the [release and upgrade notes](/release-notes/#3-3-0).
 
-- [RDF4J 3.2.3 SDK (zip)](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.2.3-sdk.zip)<br/>
+- [RDF4J 3.3.0 SDK (zip)](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.3.0-sdk.zip)<br/>
   Full Eclipse RDF4J SDK, containing all libraries, RDF4J Server, Workbench, and Console applications, and Javadoc API.
 
-- [RDF4J 3.2.3 onejar](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.2.3-onejar.jar)<br/>
+- [RDF4J 3.3.0 onejar](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.3.0-onejar.jar)<br/>
   Single jar file for easy inclusion of the full RDF4J toolkit in your Java project.
 
 - [RDF4J artifacts](https://search.maven.org/search?q=org.eclipse.rdf4j) on the [Maven Central Repository](http://search.maven.org/)
 
-# RDF4J 3.3.0 Milestone 1
-
-RDF4J 3.3.0-M1 is the first milestone build for the upcoming 3.3.0 release. It requires Java 8.
-
-- [RDF4J 3.3.0-M2 SDK (zip)](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.3.0-M2-sdk.zip)<br/>
-  Full Eclipse RDF4J SDK, containing all libraries, RDF4J Server, Workbench, and Console applications, and Javadoc API.
-
-- [RDF4J 3.3.0-M2 onejar](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.3.0-M2-onejar.jar)<br/>
-  Single jar file for easy inclusion of the full RDF4J toolkit in your Java project.
-
-
 # Apache Maven 
 
 You can include RDF4J as a Maven dependency in your Java project by including the following BOM (Bill-of-Materials):
@@ -37,7 +26,7 @@ You can include RDF4J as a Maven dependency in your Java project by including th
             <dependency>
                 <groupId>org.eclipse.RDF4J</groupId>
                 <artifactId>rdf4j-bom</artifactId>
-                <version>3.2.3</version>
+                <version>3.3.0</version>
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
@@ -58,6 +47,12 @@ which artifacts RDF4J provides.
 
 # Older releases
 
+## RDF4J 3.2
+
+- [RDF4J 3.2.3 SDK (zip)](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.2.3-sdk.zip)
+- [RDF4J 3.2.3 onejar](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.2.3-onejar.jar)
+
+
 ## RDF4J 3.1
 
 - [RDF4J 3.1.4 SDK (zip)](http://www.eclipse.org/downloads/download.php?file=/rdf4j/eclipse-rdf4j-3.1.4-sdk.zip)
@@ -92,7 +87,7 @@ To include nightly snapshot builds in your project, add this repository to your
         </repository>
      </repositories>
 
-Then use RDF4J dependencies as normal, using 3.2.3-SNAPSHOT as the version number.
+Then use RDF4J dependencies as normal, using 3.3.1-SNAPSHOT or 3.4.0-SNAPSHOT as the version number.
 
 # Archives
 

site/content/news/rdf4j-330.md

@@ -0,0 +1,24 @@
+---
+title: "RDF4J 3.3.0 released"
+date: 2020-07-24
+layout: "single"
+categories: ["news"]
+---
+We are very pleased to announce that RDF4J 3.3.0 is now available.  RDF4J 3.3.0 is a minor release with over 30 issues fixed, including several major new features and improvements. Some of the highlights:
+
+ - Per-transaction configuration settings
+ - More powerful SPARQL functions
+ - Many new SHACL features
+ - RDF Containers support
+ - Java 13 and 14 support
+ - Many more features, bug fixes and performance improvements
+
+ A shout out to 
+
+For more details, have a look at the [release notes](/release-notes/3.3.0).
+<!--more-->
+### Links
+
+- [Download RDF4J](/download/)
+- [release notes](/release-notes/3.3.0).
+

site/content/release-notes/3.3.0.md

@@ -0,0 +1,31 @@
+---
+title: "3.3.0"
+---
+RDF4J 3.3.0 is a minor release [TODO]
+
+It is backward compatible with previous RDF4J releases.
+
+Highlights:
+
+- A new mechanism for providing per-transaction configuration settings is now available in the Repository and SAIL APIs. Currently used by the [ShaclSail](https://rdf4j.org/documentation/programming/shacl/#performance).
+- The ShaclSail now supports sh:inversePath (limited to single predicates) and sh:hasValue.
+- [Custom SPARQL functions](https://rdf4j.org/javadoc/3.3.0/org/eclipse/rdf4j/query/algebra/evaluation/function/TupleFunction.html) now allow inspection of the triplestore state during evaluation.
+- Improved query plan rendering.
+- Utility functions for working with [RDF Containers](https://rdf4j.org/javadoc/3.3.0/org/eclipse/rdf4j/model/util/RDFContainers.html) (Alt, Bag, Seq) added.
+- Experimental support for various new SHACL features ([DASH and RSX](https://rdf4j.org/documentation/programming/shacl/#supported-shacl-features))
+- Elasticsearch, Lucene and Solr upgrades
+- Support for Java 13 and 14
+- Performance improvements and bug fixes
+
+For a complete overview, see [all issues fixed in 3.3.0](https://github.com/eclipse/rdf4j/milestone/51?closed=1).
+
+## Upgrade notes 
+
+This release is binary compatible with previous releases. 
+
+RDF4J 3.1.x and 3.2.x implicitly included the jackson-core, jackson-databind and jackson-annotations dependencies when using the `rdf4j-rio-api` maven artifact. In version 3.3.0, these dependencies are explicitly excluded.
+Projects relying on this unintended behavior should check if they need to add these jackson dependencies to their build files.  
+
+## Acknowledgements
+
+This release was made possible by contributions from Andreas Schwarte, Bart Hanssens, Elad Shaked, Gaurav Aggarwal, Gauri Bhatanagar, Håvard M. Ottestad, Jeen Broekstra, Navdha Agarwal, Pavel Mihailov, Prince Sachdeva, Raghav Rathi, Reeshabh Kumar Ranjan, Sakshi Saini, and Shubhi Jain.