Publish docs on readthedocs

.readthedocs.yaml

@@ -0,0 +1,18 @@
+# Read the Docs configuration file for MkDocs projects
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the version of Python and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+
+python:
+  install:
+    - requirements: ./mkdocs/requirements.txt
+
+mkdocs:
+  configuration: ./mkdocs/mkdocs.yml

README.md

@@ -1,35 +1,53 @@
-# Geotrek-rando V3
+# Geotrek-rando
 
-![Search](https://geotrek.ecrins-parcnational.fr/images/gtr3-04-search.jpg)
+![Search](img/home_ecrins.png)
 
 Geotrek-rando is the public web application displaying the interface you can use to value your territory treks and tourism products! 
-Demo available at https://gtr3demo.ecrins-parcnational.fr.
+Demo available at [https://gtr3demo.ecrins-parcnational.fr](https://gtr3demo.ecrins-parcnational.fr).
 
 The third version is a full redesign and rewriting of Geotrek-rando with React, and NextJS for Server side rendering (SSR) and SEO.
 
-Geotrek-rando v3 is directly connected to Geotrek-admin v2 API.
+Geotrek-rando is directly connected to Geotrek-admin v2 API.
 
-Read more in the [general presentation](./docs/presentation-fr.md).
+## 💡 Présentation (french)
 
-## Documentation for administrators
+Read more in the [general presentation](./presentation-fr.md).
 
-- [Installation for production](./docs/installation.md)
-- [Customization](./docs/customization.md)
+## 🚀 Installation
 
-## Documentation for developers
+- [Production setup](./installation.md)
 
-- [Installation on a dev machine](./docs/development.md)
-- [Deployment](./docs/deployment.md)
+## 🎨 Customization
 
-## Getting started
+- [Introduction](customization/customization-introduction.md)
+- [Settings](customization/customization-settings.md)
+- [Theme and style](customization/customization-themestyles.md)
+- [Icons](customization/customization-icons.md)
+- [Translation](customization/customization-translation.md)
+- [HTML and scripts](customization/customization-htmlscripts.md)
+- [GDPR](customization/customization-gdpr.md)
+- [Media management](customization/customization-mediamanagement.md)
 
-- Follow the [development](./docs/development.md) docs
-- Head to [localhost:3000](http://localhost:3000)
+## 🔧 Development
+
+- [Installation](./development/installation.md)
+- [Deployment](./development/deployment.md)
+- [Contributing](./development/contributing.md)
+
+## ✨ Knowledge 
+
+- [Caching strategies](./knowledge/caching.md)
+- [Debug mode](./knowledge/debug.md)
+- [Pages and navigation](./knowledge/pages-and-navigation.md)
+- [Server side rendering](./knowledge/server-side-rendering.md)
 
-## Architecture decision records
+## 🧱 Architecture decision record 
 
-- [Main framework](./docs/adrs/main_framework.md)
-- [Deployment solution](./docs/adrs/deployment_solution.md)
+- [Main framework](./adrs/main_framework.md)
+- [Deployment solution](./adrs/deployment_solution.md)
+
+## 🪄 Getting started
+
+- Follow the [development](./development/installation.md) docs
+- Head to [localhost:3000](http://localhost:3000)
 
-<a href="https://territoires.makina-corpus.com/"><img src="https://geotrek.fr/assets/img/logo_makina.svg" alt="Logo MCT" width="115"></a>
-[![](https://geotrek.fr/assets/img/logo_autonomens-h120m.png)](https://datatheca.com/)

docs/adrs/deployment_solution.md

@@ -6,7 +6,8 @@
 
 ## Context and Problem Statement
 
-We need to have an easy way to deploy this server for it to be runnable on the most various environments.
+This analysis has been done in 2020, when we started redesigning Geotrek-rando globally, to choose the right technology.  
+We needed to have an easy way to deploy this server for it to be runnable on the most various environments.
 
 ## Decision Drivers sorted by priority
 

docs/adrs/main_framework.md

@@ -6,7 +6,8 @@
 
 ## Context and Problem Statement
 
-In order to produce a scalable, performant and efficient front, we need to choose the right framework head start.
+This analysis has been done in 2020, when we started redesigning Geotrek-rando globally, to choose the right technology.  
+In order to produce a scalable, performant and efficient front, we needed to choose the right framework head start.
 
 ## Decision Drivers sorted by priority
 

docs/changelog.md

@@ -44,9 +44,10 @@
 
 - Install semver package
 
+
 ## 3.22.0 (2024-09-17)
 
-### :warning: **WARNING!** :warning:
+⚠️ Warning
 
 **Do not use - docker installation will not work. Please install version 3.22.1 (or higher) instead**
 
@@ -78,6 +79,7 @@
 
 - Fix display of mobile menu sub-filters (#1006 #1235)
 
+
 ## 3.21.1 (2024-07-29)
 
 **🐛 Fixes**
@@ -717,8 +719,8 @@ Require Geotrek-admin 2.98.0 (March 2023) minimum.
 
 **⚠️ Version notes**
 
-* You have to edit your `map.json` customization file to apply the new layers settings organization. See `map.json` customization in [documentation](customization.md#settings)
-* It is now possible to define home suggestions contents by language. See `home.json` customization in [documentation](customization.md#settings)
+* You have to edit your `map.json` customization file to apply the new layers settings organization. See `map.json` customization in [documentation](customization/customization-settings.md)
+* It is now possible to define home suggestions contents by language. See `home.json` customization in [documentation](customization/customization-settings.md)
 
 3.9.0 (2022-06-22)
 ------------------
@@ -1022,7 +1024,7 @@ If you update Geotrek-rando v3, the global Docker process has been updated to av
 * Install Docker Compose. See its [official documentation](https://docs.docker.com/compose/install/)
 * Launch the application with ``docker-compose up -d``
 * No need anymore to build a Docker image on your server to install or update the configuration of your Geotrek-rando
-* Details in [installation documentation](/docs/installation.md)
+* Details in [installation documentation](./installation.md)
 * You can also remove your previous Docker containers and images with launching ``docker container prune`` and ``docker image prune -a``
 
 3.1.3 (2021-09-21)