Start with the homepage (#267)

aivalidation_dictionary.txt

@@ -45,6 +45,7 @@ Friese
 geen
 gettext
 gebruiksverantwoordelijke
+Gilde
 glightbox
 Granian
 GUI
@@ -53,6 +54,7 @@ Haitsma
 Hanze
 Hartog
 hoog
+htmltitle
 HTMX
 HUIDERIA
 IAMA
@@ -100,6 +102,7 @@ Ravi
 ravimeijerrig
 Renate
 Rijk
+Rijks
 Rijkshuisstijl
 rijksoverheid
 risico
@@ -110,6 +113,7 @@ ROOS
 rubenrouwhof
 RVO
 Schuth
+scrollwrap
 SENSUS
 serverside
 SHAP

cspell.config.yaml

@@ -4,3 +4,6 @@ dictionaryDefinitions:
     addWords: true
 dictionaries:
   - AIValidation
+
+ignorePaths:
+  - '**/*.svg'

docs/index.md

@@ -1,37 +1,5 @@
 ---
-hide:
-  - navigation
+template: home.html
 ---
 
-# Home
-
-Here we are documenting the processes and work of the [AI Validation Team](about/team.md) at the [Ministry of the
-Interior and Kingdom Relations](https://www.government.nl/ministries/ministry-of-the-interior-and-kingdom-relations) in
-The Netherlands.
-
-We are a team of engineers, UX designers & researchers, and product experts at a policy department.
-
-We work on the following projects within the _Transparency of Algorithmic Decision making_ scope:
-
-``` mermaid
-graph TB
-    ak[<a href='https://minbzk.github.io/Algoritmekader/'>Algoritmekader</a>] <--> amt
-
-    subgraph amt[<a href='https://amt.prd.apps.digilab.network'>Algorithm Management Toolkit</a>]
-        tr[<a href='https://minbzk.github.io/task-registry'>Task Registry</a>] --> amp[<a href='https://github.com/MinBZK/amt/'>Algorithm Management Platform</a>]
-        st[<a href='/ai-validation/projects/amt/reporting-standard/'>Reporting Standard</a>] --> amp
-        amp <--> ai_act_decision_tree[<a href='https://ai-act-decisiontree.apps.digilab.network'>AI Act Decision Tree</a>]
-        amp <--> llm[<a href='/ai-validation/projects/llm-benchmarks/'>LLM Benchmark Tooling</a>]
-    end
-
-    amt --> ar[<a href='https://algoritmes.overheid.nl/en/'>The Algorithm Register of the Dutch government</a>]
-    amt --> or[Other registries]
-```
-
-## Contribute
-
-Read our guide on [how to contribute](way-of-working/contributing.md).
-
-## Contact
-
-Our [contact details are here](about/contact.md).
+# AI Validation Team

docs/stylesheets/extra.css

@@ -1,3 +1,36 @@
 img.round {
   border-radius: 50%;
 }
+
+.rvo-logo {
+    align-items:center;
+    display:flex;
+    flex-direction:row;
+    gap:10px;
+    max-width:206px
+}
+
+.rvo-logo__emblem{
+    align-self: flex-start;
+    height:80px;
+    min-width:40px;
+    width:40px
+}
+
+.rvo-header__logo-wrapper{
+    margin-inline-start:calc(50% - 20px)
+}
+
+.md-header__inner{
+    display:flex;
+    justify-content: space-between;
+    align-items: flex-start;
+}
+
+.md-header__extra{
+    display:flex;
+    align-items: flex-end;
+    position: absolute;
+    position: top: 10px; /* Adjust as needed */
+    right: 20%; /* Adjust as needed */;
+}

mkdocs.yml

@@ -1,73 +1,62 @@
+# Project information
 site_name: AI Validation Team
-site_description: Documenting the processes of the AI Validation Team at the Ministry of the Interior and Kingdom Relations in The Netherlands.
 site_url: https://minbzk.github.io/ai-validation/
+site_description: >-
+  Documenting the processes of the AI Validation Team at the Ministry of the
+  Interior and Kingdom Relations in The Netherlands.
 
-copyright: European Union Public License v. 1.2
-
+# Repository
 repo_name: MinBZK/ai-validation
 repo_url: https://github.com/MinBZK/ai-validation
 edit_uri: edit/main/docs/
 
+extra:
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/MinBZK/ai-validation
+
+extra_templates:
+  - .well-known/security.txt
+
+# Copyright
+copyright: European Union Public License v. 1.2
+
+# Configuration
 theme:
   name: material
   custom_dir: overrides
-  language: en
-  palette:
-    primary: deep orange
-    scheme: slate
   features:
+    - announce.dismiss
     - content.action.edit
+    - content.action.view
+    - content.code.annotate
     - content.code.copy
+    - content.code.select
+    - content.footnote.tooltips
+    - content.tooltips
+    - navigation.footer
     - navigation.indexes
-    - navigation.instant
-    - navigation.path
+    - navigation.sections
     - navigation.tabs
     - navigation.tabs.sticky
     - navigation.top
-    - navigation.tracking
     - search.highlight
+    - search.share
     - search.suggest
+    - toc.follow
+  palette:
+    primary: white
+    scheme: slate
   icon:
-    logo: fontawesome/solid/house
-    annotation: fontawesome/solid/circle-info
-
-markdown_extensions:
-  - pymdownx.superfences:
-      custom_fences:
-        - name: mermaid
-          class: mermaid
-          format: !!python/name:pymdownx.superfences.fence_code_format
-  - pymdownx.tabbed:
-      alternate_style: true
-  - pymdownx.superfences
-  - footnotes
-  - pymdownx.details
-  - admonition
-  - attr_list
-  - abbr
-  - md_in_html
-  - pymdownx.tasklist:
-      custom_checkbox: true
-  - pymdownx.emoji:
-      emoji_index: !!python/name:material.extensions.emoji.twemoji
-      emoji_generator: !!python/name:material.extensions.emoji.to_svg
-
-extra:
-  social:
-    - icon: fontawesome/brands/github
-      link: https://github.com/MinBZK/ai-validation
-
-extra_css:
-  - stylesheets/extra.css
-
-extra_templates:
-  - .well-known/security.txt
-
-watch:
-  - overrides/
+    logo: logo
+  language: en
 
+# Plugins
 plugins:
   - awesome-pages
+  - meta
+  - search:
+      separator: '[\s\u200b\-_,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
   - git-committers:
       repository: minbzk/ai-validation
       branch: main
@@ -77,8 +66,51 @@ plugins:
   - privacy
   - search
 
+extra_css:
+  - stylesheets/extra.css
+
+markdown_extensions:
+  - abbr
+  - admonition
+  - attr_list
+  - def_list
+  - footnotes
+  - md_in_html
+  - pymdownx.arithmatex:
+      generic: true
+  - pymdownx.betterem:
+      smart_enable: all
+  - pymdownx.caret
+  - pymdownx.details
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.keys
+  - pymdownx.magiclink:
+      normalize_issue_symbols: true
+      repo_url_shorthand: true
+      user: MinBZK
+      repo: ai-validation
+  - pymdownx.mark
+  - pymdownx.smartsymbols
+  - pymdownx.snippets:
+      auto_append:
+        - includes/mkdocs.md
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  - pymdownx.tabbed:
+      alternate_style: true
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - pymdownx.tilde
+
 nav:
-  - Home: index.md
+  - AI Validation Team: index.md
   - Projects:
     - AMT:
       - projects/amt/index.md
@@ -103,7 +135,7 @@ nav:
         - Checklist:
           - ... | flat | projects/amt/existing-tools/checklists/*
     - LLM Benchmarks:
-      - projects/llm-benchmarks/index.md
+      - projects/LLM-Benchmarks/index.md
   - Way of Working:
     - way-of-working/principles.md
     - way-of-working/contributing.md
@@ -112,5 +144,5 @@ nav:
       - ... | flat | way-of-working/onboarding/*
     - way-of-working/off-boarding.md
     - way-of-working/decision-log.md
-  - ... | adrs/*
-  - ... | about/*
+  - About us:
+    - ... | about/*