From fa8999a455c6dae8a52c43ca38b3450ee7246da2 Mon Sep 17 00:00:00 2001 From: Steve Crouch <s.crouch@software.ac.uk> Date: Tue, 19 Feb 2019 15:56:55 +0000 Subject: [PATCH] Initial content for index page, stub user guide --- docs/source/guide_user.rst | 17 ++++++++++++ docs/source/index.rst | 56 ++++++++++++++++++++++++++++++++------ 2 files changed, 65 insertions(+), 8 deletions(-) create mode 100644 docs/source/guide_user.rst diff --git a/docs/source/guide_user.rst b/docs/source/guide_user.rst new file mode 100644 index 0000000..2b4de1e --- /dev/null +++ b/docs/source/guide_user.rst @@ -0,0 +1,17 @@ +.. _guide_user: + +PEDASI User Guide +================= + +.. toctree:: + :maxdepth: 2 + :caption: Contents: + + + +References +********** + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` diff --git a/docs/source/index.rst b/docs/source/index.rst index 54593fd..99ef440 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -1,19 +1,59 @@ -.. PEDASI documentation master file, created by - sphinx-quickstart on Fri Aug 17 13:18:08 2018. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. +.. _doc-index: -Welcome to PEDASI's documentation! -================================== +PEDASI +====== .. toctree:: :maxdepth: 2 :caption: Contents: +Overview +******** -Indices and tables -================== +Developed as a platform and a service to explore research challenges in data security, privacy, and ethics, PEDASI enables providers of data - particularly `Internet of Things`_ data - to share their data securely within a common catalogue for use by application developers and researchers. Data can either be hosted and made accessible directly within PEDASI as an internal data source, or hosted elsewhere and accessible as an external data source through PEDASI. + +An initial deployment of the platform is available at https://dev.iotobservatory.io. + +.. _`Internet of Things`: https://en.wikipedia.org/wiki/Internet_of_things + + +Key Features +************ + +PEDASI's key features are: + + - Searchable catalogue of supported data sources registered by data owners + - Extensible connector interface that currently supports HyperCat and IoTUK Nation Database data sources + - Dataset discovery and access via a web interface or via an Applications API + - Queryable and extensible metadata associated with datasets + - Adoption of W3C PROV-DM specification to track and record dataset creation, update, and access within internal datastore + - Internally hosted support for read/write NoSQL datastores + - Functions as a reverse proxy to data sources, returning data from requests exactly as supplied by the data source + + +Resources +********* + +Documentation is available within this repository for the following stakeholders: + + - :ref:`Researchers and other end-users<guide_user>`: to discover, explore, and make use of datasets using the web interface + - :ref:`Administrators<guide_administrator>`: to deploy PEDASI, or provide data or use applications through PEDASI + - :ref:`Application developers<guide_developer>`: to develop applications that access data available through PEDASI + +This documentation is also available on `Read the Docs`_. + +.. _`Read the Docs`: https://pedasi.readthedocs.io/en/dev + + +License +******* + +PEDASI is provided under the MIT licence. + + +References +********** * :ref:`genindex` * :ref:`modindex` -- GitLab