diff --git a/source/conf.py b/source/conf.py index e254ba6..02de140 100644 --- a/source/conf.py +++ b/source/conf.py @@ -79,7 +79,7 @@ # built documents. # # The short X.Y version. -version = u'2023.01' +version = u'2023.07' # The full version, including alpha/beta/rc tags. release = version diff --git a/source/quickstart.rst b/source/quickstart.rst index 8e42844..68c85cf 100644 --- a/source/quickstart.rst +++ b/source/quickstart.rst @@ -4,112 +4,18 @@ Quickstart ============ +Over the years, the |odh| Project has grown and there are now many +possibilities to find information on the |odh| project or to interact +with it. -This section helps you in getting quickly in touch with the most -popular tools developed by |odh| to interact with the dataset and -the whole ecosystem. +Information about the |odh| project, its goal, and possibility to +interact or collaborate with it can be found in this documentation's +sections :ref:`project-overview`, :ref:`getting-involved`, +:ref:`architecture-odh`, and :ref:`data-access`. -At the time of writing, all tools that have been developed are -available online: they are summarised in the following table. +A complete list of the tools and resources developed and available for +everyone (including the Data browser, analytics tools, API and +programmatic access, the Web Components Store) can be found on the +|odh| portal's `Quickstart page +`_. -.. grid:: - :gutter: 3 - - .. grid-item-card:: - :columns: 6 - - Data Browser - ^^^^^ - - The |odh| `Tourism Data Browser - `_ allows to access all - the Open Data available in the Tourism domain by simply browsing - the content of the various datasets. - - You can simply use those data for your convenience, or you might - even find a novel way to exploit those data and use them in an - app or portal you are going to develop. A detailed howto is - available: :ref:`tourism-data-browser-howto` to help you getting - acquainted with the browser. - - Currently, the Data Browser is being developed to be able to - access also data in the Mobility domain as well. - - .. grid-item-card:: - :columns: 6 - - Analytics tools - ^^^^^ - - Open the :strong:`Analytics for Mobility` web page, at - https://analytics.opendatahub.com/ This portal uses data in - the mobility domain to display various information about the - sensors, including their locations, what they measure, and - actual data in near-real time. You can retrieve data gathered by - the sensors directly from the dataset, in almost real-time. - - .. grid-item-card:: - :columns: 6 - - Swagger API interface - ^^^^^ - - The |odh| team has developed REST APIs to programmatically - access both the Tourism and Mobility domains. You can access - their swagger interface to browse the data and learn how to use - the API. You will be guided in building the query and will - receive as a result both all the data satisfying the query and - the full query in a format that you can use with the - :command:`curl` command from a shell or a script. - - .. tab-set:: - - .. tab-item:: Mobility resources - - * :octicon:`triangle-right` The URL of the Swagger - interface is https://mobility.api.opendatahub.com/ - - * :octicon:`triangle-right` Check out the `Mobility - dedicated howto` (:ref:`get-started-mobility`) that will - guide you in the first steps. - - .. tab-item:: Tourism resources - - * :octicon:`triangle-right` The URL of the Swagger - interface is - https://tourism.opendatahub.com/swagger/ui/index - - * :octicon:`triangle-right` Check out the `Tourism - dedicated howto` (:ref:`tourism-data-howto`) that will - guide you in the first steps. - - .. grid-item-card:: - :columns: 6 - - Web Component Store - ^^^^^ - - Web Components are a W3C's effort to provide standard components - for the Web. Anyone can create a Web Component, using standard - languages like CSS, JSON, HTML and share it with other, in this - cae with the |Odh| community. - - If you have developed a :term:`Web Component` that you deem - useful for the |odh| project or that can be used on top of data - provided by the |odh|, you can share it and allow other to reuse - it, by making it freely available on |odh|\'s `Web Components - Store `_. - - The only requirement for all the Web Components offered through - the Store is that they :strong:`must` be released as an - :ref:`Open Source Licence `, compatible with those - used within the |odh| project. - - To help you in the process of publishing your Web Component in - |odh|'s store, check the howto: :ref:`webcomponents`. - -.. seealso:: More information about the |odh| project, its goal, and - possibility to interact or collaborate with it can be found in - sections :ref:`project-overview`, :ref:`getting-involved`, - :reF:`architecture-odh`, :ref:`available_datasets`, - :ref:`data-access`.