add docs for OGC API transactions [skip ci]

Author: tomkralidis

docs/en/features.rst

@@ -58,7 +58,9 @@ OGC API Support
 +--------------------------------------------------------------------------------------+------------+
 | `OGC API - Records - Part 1: Core`_                                                  | draft      |
 +--------------------------------------------------------------------------------------+------------+
-| `OGC API - Features - Part 3: Filtering and the Common Query Language (CQL) draft`_  | draft      |
+| `OGC API - Features - Part 3: Filtering and the Common Query Language (CQL)`_        | draft      |
++--------------------------------------------------------------------------------------+------------+
+| `OGC API - Features - Part 4: Create, Replace, Update and Delete`_                   | draft      |
 +--------------------------------------------------------------------------------------+------------+
 | `OGC API - Processes - Part 1: Core`_                                                | 1.0        |
 +--------------------------------------------------------------------------------------+------------+
@@ -89,6 +91,7 @@ OGC API Support
 .. _`OGC API`: https://ogcapi.ogc.org
 .. _`OGC API - Features - Part 1: Core`: https://docs.opengeospatial.org/is/17-069r3/17-069r3.html
 .. _`OGC API - Records - Part 1: Core`: https://github.com/opengeospatial/ogcapi-records
-.. _`OGC API - Features - Part 3: Filtering and the Common Query Language (CQL) draft`: https://docs.ogc.org/DRAFTS/19-079.html
+.. _`OGC API - Features - Part 3: Filtering and the Common Query Language (CQL)`: https://docs.ogc.org/DRAFTS/19-079.html
+.. _`OGC API - Features - Part 4: Create, Replace, Update and Delete`: https://docs.ogc.org/DRAFTS/20-002.html
 .. _`OGC API - Coverages - Part 1: Core`: https://docs.ogc.org/DRAFTS/19-087.html
 .. _`OGC API - Processes - Part 1: Core`: https://docs.ogc.org/is/18-062r2/18-062r2.html

docs/en/usage.rst

@@ -273,6 +273,46 @@ OGC API - Records - Part 1: Core 1.0
   >>> my_catalogue_cql_json_query['features'][0]['properties']['title']
   u'Roadrunner ambush locations'
 
+
+OGC API - Features - Part 4: Create, Replace, Update and Delete
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. note::
+
+   This specification applies to both OGC API - Features and OGC API - Records
+
+
+.. code-block:: python
+
+   import json
+   from owslib.ogcapi.records import Records
+
+   record_data = '/path/to/record.json'
+
+   url = 'http://localhost:8000'
+   collection_id = 'metadata:main'
+
+   r = Records(url)
+
+   cat = r.collection(collection_id)
+
+   with open(record_data) as fh:
+       data = json.load(fh)
+
+   identifier = data['id']
+
+   r.collection_item_delete(collection_id, identifier)
+
+   # insert metadata
+   r.collection_item_create(collection_id, data)
+
+   # update metadata
+   r.collection_item_update(collection_id, identifier, data)
+
+   # delete metadata
+   r.collection_item_delete(collection_id, identifier)
+
+
 OGC API - Processes - Part 1: Core 1.0
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^