Doc styling and minor changes (#526)

Author: PGijsbers

docs/README.md

@@ -1,14 +1,14 @@
 # 🇪🇺 AI-on-Demand Metadata Catalogue
 
-The AI-on-Demand Metadata Catalogue provides a unified view of AI assets and resources stored across the AI landscape.
+The [AI-on-Demand](https://aiod.eu) Metadata Catalogue is part of the provides a unified view of AI assets and resources stored across the AI landscape.
 It collects metadata from platforms such as [_Hugging Face_](https://huggingface.co), [_OpenML_](https://openml.org), and [_Zenodo_](https://zenodo.org),
 and is connected to European projects like [Bonsapps](https://bonsapps.eu) and [AIDA](https://www.i-aida.org).
-Metadata of datasets, models, papers, news, and more from all of these sources is available through a REST API at [api.aiod.eu](https://api.aiod.eu/).
+Metadata of datasets, models, papers, news, and more from all of these sources is available through a REST API at [https://api.aiod.eu](https://api.aiod.eu/).
 
 **🧑‍🔬 For most users:**
 Many users will only use the REST API indirectly, for example;
-through the [Python SDK](https://aiondemand.github.io/aiondemand/) to access all (meta)data in Python scripts, the 
-[AIoD website](aiod.eu), including services such as [My Resources](https://github.com/aiondemand/AIOD-marketplace-frontend/) to browse assets,
+through the [Python SDK](https://aiondemand.github.io/aiondemand/) to access all (meta)data in Python scripts, the
+[AIoD website](https://aiod.eu), including services such as [My Resources](https://github.com/aiondemand/AIOD-marketplace-frontend/) to browse assets,
 and [RAIL](https://github.com/aiondemand/aiod-rail) to conduct reproducible ML experiments.
 For documentation on how to use the REST API directly, visit the ["Using the API"](https://aiondemand.github.io/AIOD-rest-api/using/) guide.
 

docs/hosting/index.md

@@ -114,6 +114,7 @@ Then run the startup commands again (either `up.sh` or `docker compose`).
 By default, the server will create a database on the provided MySQL server if it does not yet exist.
 You can change this behavior through the **build-db** command-line parameter,
 it takes the following options:
+
 * never: *never* creates the database, not even if there does not exist one yet.
   Use this only if you expect the database to be created through other means, such
   as MySQL group replication.

docs/media/secondary-neg-white-25p.webp

@@ -0,0 +1,33 @@
+:root  > * {
+  --md-primary-fg-color:  #0047BB; /* banner */
+}
+
+[data-md-color-scheme=slate] {
+    --md-default-fg-color: #C5C6C8;
+    --md-default-fg-color--light: #C5C6C8;
+}
+
+[data-md-color-scheme=default] {
+    --md-default-fg-color: #545557;
+}
+
+
+/* AIOD colors
+dark blue: #0047BB
+alternative dark blue: #003399:
+light blue: #41B6E6
+yellow: #FFED00
+dark gray: #646567
+light gray: #C5C6C8
+ */
+
+/* At the default height and margin, the logo for AIoD is not recognizable. */
+.md-header__button.md-logo {
+    margin: 0;
+    padding: 0;
+}
+
+.md-header__button.md-logo img, .md-header__button.md-logo svg {
+    height: 2.4rem;
+    width: 2.4rem;
+}

docs/media/upload_and_review.svg

@@ -4,11 +4,17 @@ The REST API allows you to retrieve, update, or remove asset metadata in the met
 The assets are indexed from many different platforms, such as educational resources from [AIDA](https://www.i-aida.org),
 datasets from [HuggingFace](https://huggingface.co), models from [OpenML](https://openml.org), and many more.
 
-The REST API is available at [`https://api.aiod.eu`](https://api.aiod.eu) and documentation on endpoints
+The REST API is available at [https://api.aiod.eu](https://api.aiod.eu) and documentation on endpoints
 is available on complementary [Swagger](https://api.aiod.eu/docs) and [ReDoc](https://api.aiod.eu/redoc) pages.
 
 To use the REST API, simply make HTTP requests to the different endpoints.
-Generally, these are `GET` requests when retrieving data, `PUT` requests when modifying data, `POST` requests when adding data, and `DEL` requests when deleting data.
+Generally, these are `GET` requests when retrieving data, `PUT` requests when modifying data, `POST` requests when adding data, and `DEL` requests when deleting data. The video and text below show examples on how to use the REST API.
+
+## Introduction Video
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/2nDj1_VjcWM?si=ncD7xaifSmbU5uzZ" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+
+## A Quick Example
 Here are some examples on how to list datasets in different environments:
 
 === "Python (requests)"

docs/stylesheets/extra.css

@@ -4,6 +4,7 @@ repo_url: https://github.com/aiondemand/AIOD-rest-api
 edit_uri: edit/develop/docs/
 theme:
   name: material
+  logo: media/secondary-neg-white-25p.webp
   features:
     - content.code.copy
     - navigation.footer
@@ -12,6 +13,8 @@ theme:
   icon:
     edit: material/pencil
     view: material/eye
+  font:
+    text: 'Montserrat'
   palette:
     # Palette toggle for light mode
     - media: "(prefers-color-scheme: light)"
@@ -27,6 +30,9 @@ theme:
         icon: material/brightness-4
         name: Switch to light mode
 
+extra_css:
+  - stylesheets/extra.css
+
 
 nav:
   - Home: README.md