Merge pull request #1330 from datanav/docs/warn-against-direct-dataset-writes

docs: warn against writing directly to datasets via API in production

Author: Ole-Morten

hub/api.rst

@@ -150,6 +150,11 @@ With curl:
 Get a list of all the datasets
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. warning::
+
+   Do not use the dataset API to write data in production. To push data into Sesam, use either an
+   :ref:`HTTP endpoint source <http_endpoint_source>` or the :ref:`JSON Push Protocol <json_push_protocol>`.
+
 With curl:
 
 ::

hub/json-push.rst

@@ -1,3 +1,5 @@
+.. _json_push_protocol:
+
 ==================
 JSON Push Protocol
 ==================