summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/developers.rst8
-rw-r--r--docs/index.rst6
-rw-r--r--docs/sphinx-requirements.txt2
-rw-r--r--docs/upgrade5to6.rst21
4 files changed, 30 insertions, 7 deletions
diff --git a/docs/developers.rst b/docs/developers.rst
index b8c8310c..56d6761b 100644
--- a/docs/developers.rst
+++ b/docs/developers.rst
@@ -12,7 +12,8 @@ developing RDFLib code.
Please be as Pythonic as possible (:pep:`8`).
Code should be formatted using `black <https://github.com/psf/black>`_.
-While not yet mandatory, it will be required in the future (6.0.0+).
+While not yet mandatory, it will be required in the future (6.0.0+).1
+Use Black v21.6b1, with the black.toml config file provided.
Any new functionality being added to RDFLib should have doc tests and
unit tests. Tests should be added for any functionality being changed
@@ -22,6 +23,7 @@ did not break anything.
If you add a new cool feature, consider also adding an example in ``./examples``
+
Running tests
-------------
Run tests with `nose <https://nose.readthedocs.org/en/latest/>`_:
@@ -61,9 +63,9 @@ flag them as expecting to fail.
Compatibility
-------------
-RDFLib 5.x.y tries to be compatible with python versions 2.7, 3.4, 3.5, 3.6, 3.7.
+RDFLib 5.0.0 maintained compatibility with python versions 2.7, 3.4, 3.5, 3.6, 3.7.
-The current master branch (which will be released as 6.0.0) will only support Python 3.6 and newer.
+The latest 6.0.0 release and subsequent will only support Python 3.7 and newer.
Releasing
diff --git a/docs/index.rst b/docs/index.rst
index 94f97218..b79c75a1 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -8,8 +8,8 @@ RDFLib is a pure Python package for working with `RDF <http://www.w3.org/RDF/>`_
* **Parsers & Serializers**
- * for RDF/XML, N3, NTriples, N-Quads, Turtle, TriX, RDFa and Microdata
- * and JSON-LD, via a plugin module
+ * for RDF/XML, N3, NTriples, N-Quads, Turtle, TriX, JSON-LD, RDFa and Microdata
+
* **Store implementations**
@@ -130,4 +130,4 @@ Here are a few RDF and Python terms referred to in this documentation. They are
The Resource Description Framework (RDF) is a framework for representing information in the Web. RDF data is
stored in graphs that are sets of subject-predicate-object triples, where the elements may be IRIs, blank nodes,
or datatyped literals. See the `OWL 2 Web Ontology Language
- Document Overview <http://www.w3.org/TR/owl-overview/>`_ for more info. \ No newline at end of file
+ Document Overview <http://www.w3.org/TR/owl-overview/>`_ for more info.
diff --git a/docs/sphinx-requirements.txt b/docs/sphinx-requirements.txt
index b4f0ddd9..c4938f6f 100644
--- a/docs/sphinx-requirements.txt
+++ b/docs/sphinx-requirements.txt
@@ -1,3 +1,3 @@
-sphinx==4.0.2
+sphinx==4.1.0
sphinxcontrib-apidoc
git+https://github.com/gniezen/n3pygments.git
diff --git a/docs/upgrade5to6.rst b/docs/upgrade5to6.rst
index ecaf3631..7ffa7e68 100644
--- a/docs/upgrade5to6.rst
+++ b/docs/upgrade5to6.rst
@@ -16,6 +16,23 @@ compatible with. If you need very long-term backwards-compatibility or Python 2
Major Changes
-------------
+The most notable changes in RDFLib 6.0.0 are:
+
+Python 3.7+
+^^^^^^^^^^^
+* The oldest version of python you can use to run RDFLib is now 3.7.
+* This is a big jump from RDFLib 5.0.0 that worked on python 2.7 and 3.5.
+* This change is to allow the library maintainers to adopt more modern development tools,
+ newer language features, and avoid the need to support EOL versions of python in he future
+
+JSON-LD integration and JSON-LD 1.1
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+* The json-ld serializer/parser plugin was by far the most commonly used RDFLib addon.
+* Last year we brought it under the RDFLib org in Github
+* Now for 6.0.0 release the JSON-LD serializer and parser are integrated into RDFLib core
+* This includes the experimental support for the JSON-LD v1.1 spec
+* You no longer need to install the json-ld dependency separately.
+
All Changes
-----------
@@ -56,3 +73,7 @@ Documentation Fixes:
^^^^^^^^^^^^^^^^^^^^
* Fix a doc string in the query module
`PR #976 <https://github.com/RDFLib/rdflib/pull/976>`_
+
+Integrade JSON-LD into RDFLib:
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+`PR #1354 <https://github.com/RDFLib/rdflib/pull//1354>`_