Merge pull request #243 from noi-techpark/issue-225-alpinebits-section

Issue 225 alpinebits section

source/access-odh.rst

@@ -123,15 +123,15 @@ by the |odh| team.
 .. grid::
    :gutter: 1
 
-   
-   .. grid-item-card:: 
+
+   .. grid-item-card::
       :columns: 6
 
       .. _ab-access:
 
       AlpineBits client
       ^^^^^^^^^^^^^^^^^
-      .. include:: /includes/AlpineBits.rst
+      .. include:: /includes/ab-short.rst
 
    .. grid-item-card::
       :columns: 6
@@ -140,22 +140,22 @@ by the |odh| team.
 
       Statistical Access with R
       ^^^^^^^^^^^^^^^^^^^^^^^^^
-      
+
       .. include:: /includes/R.rst
 
    .. grid-item-card::
       :columns: 6
-      
+
       .. _ninja api:
 
       API
       ^^^
-      
+
       .. include:: /includes/API.rst
 
    .. grid-item-card::
       :columns: 6
-      
+
       .. _cli-access:
 
       CLI access
@@ -164,5 +164,18 @@ by the |odh| team.
 
 .. odh vkg km
 
+.. _datasets-km:
+
+.. _odh-vkg:
+
+The |odh| Virtual Knowledge Graph
+---------------------------------
+
 .. include:: /includes/kg.rst
 
+.. _alpinebits_client:
+
+The AlpineBits Client
+---------------------
+
+.. include:: /includes/AlpineBits.rst

source/changelog.rst

@@ -199,3 +199,16 @@ documentation.
       <https://github.com/executablebooks/sphinx-panels>`_ extension
       has been replaced by its successor, `sphinx-design
       <https://github.com/executablebooks/sphinx-design>`_.
+
+
+.. changelog::
+   :version: 2021.09
+   :released: 30 September 2021
+
+   .. change::
+      :tags: Improvement, New Feature
+      :tickets: 225
+
+      AlpineBits DestinationData and HotelData have now a dedicated
+      page.
+

source/conf.py

@@ -73,7 +73,7 @@
 # built documents.
 #
 # The short X.Y version.
-version = u'2021.08'
+version = u'2021.09'
 # The full version, including alpha/beta/rc tags.
 release = version
 

source/includes/AlpineBits.rst

@@ -2,23 +2,60 @@
    :scale: 30%
    :align: right
 
+.. versionadded:: 2021.09 Dedicated section for AlpineBits.
+
 The AlpineBits Alliance strives to develop and to spread a standard
 format to exchange tourism data. There are two datasets they developed
 and keep up to date, that are of particular interest for |odh| users:
-HotelData and DestinationData
+HotelData and DestinationData.
+
+.. _ab-dd:
+
+DestinationData
+```````````````
+
+The `AlpineBits DestinationData
+<https://www.alpinebits.org/destinationdata/>`_ is a standardisation
+effort to allow the exchange of information related to mountains,
+events, tourism. Developed by the AlpineBits Alliance, Destination
+Data relies on a number of standards (Including :term:`json`, REST
+API, Schema.org, OntoUML to build the :strong:`AlpineBits
+DestinationData Ontology`, the core result of the effort. The goal of
+`DestinationData` it to provide a means to describe events, their
+location, and additional information on them. For this purpose, the
+DestinationData Ontology specifies a number of :strong:`Named
+Entities` used to describe `Events` and `Event Series`, `Mountain
+Areas`, `Places`, `Trails`, `Agents`, and so on.
+
+The full specification of the ontology, including architecture of the
+API and description of the datatypes defines can be found in the
+latest :strong:`2021-04 version` of the official :strong:`Destination
+Data specs` (`pdf
+<https://www.alpinebits.org/wp-content/uploads/2021/05/AlpineBits-DestinationData-2021-04.pdf>`_
+).
+
+The :strong:`reference implementation` of AlpineBits DestinationData
+is provided by |odh| and publicly available at the dedicated endpoint at
+https://destinationdata.alpinebits.opendatahub.bz.it/.
+
+.. seealso:: More information and resources about AlpineBits
+   DestinationData can be found on the `official page
+   <https://www.alpinebits.org/destinationdata/>`_.
+
+.. _ab-hd:
+
+HotelData
+`````````
 
+The `AlpineBits HotelData <https://www.alpinebits.org/hoteldata/>`_ is
+meant for data strictly related to hotels and booking, like Inventory
+Basic, Inventory HotelInfo, and FreeRooms. This dataset can be access
+from the dedicated endpoint at
+https://alpinebits.opendatahub.bz.it/AlpineBits/
 
-The :strong:`AlpineBits HotelData` dataset (see
-https://www.alpinebits.org/hoteldata/) is meant for data strictly
-related to hotels and booking, like Inventory Basic, Inventory
-HotelInfo, and FreeRooms. This dataset can be access from the
-dedicated endpoint at https://alpinebits.opendatahub.bz.it/AlpineBits
+.. seealso::
 
-.. seealso:: The dedicated howto :ref:`ab-howto`
+   The dedicated howto :ref:`ab-howto`.
 
-The :strong:`AlpineBits DestinationData` dataset (see
-https://www.alpinebits.org/destinationdata/) is meant to gather data
-about Events and mountain-related information that can be used to find
-activities during a stay in a hotel.  This dataset can be access from
-the dedicated Endpoint at
-https://destinationdata.alpinebits.opendatahub.bz.it
+   The `official page
+   <https://www.alpinebits.org/destinationdata/>`_ of AlpineBits HotelData.

source/includes/ab-short.rst

@@ -0,0 +1,12 @@
+
+The AlpineBits Alliance strives to develop and to spread a standard
+format to exchange tourism data. |odh| allows access to all data
+produced by AlpineBits using dedicated endpoints:
+
+The :ref:`AlpineBits HotelData <ab-hd>` dataset can be access from
+https://alpinebits.opendatahub.bz.it/AlpineBits/.
+
+.. seealso:: The dedicated howto :ref:`ab-howto`
+
+The :ref:`AlpineBits DestinationData <ab-dd>` endpoint is available at
+https://destinationdata.alpinebits.opendatahub.bz.it/.

source/includes/kg.rst

@@ -1,11 +1,4 @@
 
-.. _datasets-km:
-
-.. _odh-vkg:
-
-The |odh| Virtual Knowledge Graph
----------------------------------
-
 .. versionadded:: 2021.02 Description of the Knowledge Model
    underlying datasets Accommodation, Gastronomy, and Event