From 38bbd2fbeaec8f5d22979869fffa017c603e88e6 Mon Sep 17 00:00:00 2001
From: Tonton Th <tth@linda.buvette.org>
Date: Thu, 18 Jun 2026 02:15:17 +0200
Subject: [PATCH] moare doc...

---
 Jouets.md | 78 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 README.md | 17 +++++++++---
 2 files changed, 91 insertions(+), 4 deletions(-)
 create mode 100644 Jouets.md

diff --git a/Jouets.md b/Jouets.md
new file mode 100644
index 0000000..871287b
--- /dev/null
+++ b/Jouets.md
@@ -0,0 +1,78 @@
+# Les jouets
+
+Comme pour la plupart de mes projets informatiques, je suis parti
+sur une vague idée (dont je n'ai aucun souvenir) et ensuite, je
+rajoute de multiples itérations de
+[rache](https://la-rache.com/certificat.html#tTh%20des%20Bourtoulots),
+alors forcément le code n'est pas très clair tout comme mes intentions
+de pseudo-créateur.
+
+Alors, je vais écrire des choses vaguement inutiles afin de vous aider
+à ne pas comprendre grand-chose au bouzin. Un peu de technique,
+un peu de pensées diverses, un peu d'imaginaire, tout ce qui
+fait la vie du poviste néo-rural.
+
+La plupart des choses dont je cause sont dans des fichiers
+placés dans le répertoire [incs](./incs/) et vraiment très
+mal commentés.
+
+
+## constantes
+
+*Un peu de sérieux !* Dans ce [fichier](./incs/constantes.inc), on
+trouve, pour le moment, essentiellement deux choses :
+
+* Des valeurs numériques pour la géométrie des choses, l'écartement
+  des rails, la taille des roues...
+* Les textures qui servent à donner de pinpantes couleurs à
+  toutes ces choses plus ou moins bien formées.
+
+
+## benne
+
+## citerne
+
+## corail
+
+## decor
+
+## electric
+
+## enseigne
+
+Comme nous sommes dans un univers ferriovaire, nous devons clairement
+afficher des choses, sur le coté de nos wagons, aux frontons de nos
+gares, et sur les dispositifs qui règlent nos vies.
+
+## galerie
+
+## gare
+
+## grue
+
+*Une cinématique extrèmement complexe basé sur une hiérachie de
+transformées imbriquées dans une cascade indécente de composants
+complexes imbriqués dans un assemblage de ...*
+
+
+## instruments
+
+Chaque machine a besoin d'un tachymetre, d'un presostat, et d'un
+petit affichage qui frétille.
+
+## locomotive
+
+## poteaux
+
+## rails
+
+## ridelles
+
+## rotonde
+
+Il faut bien un endroit où garer ces jolies voitures.
+
+## train
+
+## voiture
+
diff --git a/README.md b/README.md
index 75df922..47a0c1d 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,21 @@
 # PovJouets
 
-Un très très vieux projet POVray qui revient dans le triste
-monde de 2021.
-Et qui revient en forme pour attaquer **2025** ?
+C'est un très très vieux
+[projet](http://maison.tth.netlib.re/pov/jouets.html) en POVray qui
+revient dans le triste
+monde de 2021, un monde que nous essayons de ranger dans un recoin
+de nos mémoires, à la rubrique *never again*.
+Un projet qui reviendrait en forme pour attaquer la deuxième canicule de
+**2026** ?
 
-https://git.tetalab.org/tTh/PovJouets
+Coté code, tout est bien en place dans le
+[tetagit](https://git.tetalab.org/tTh/PovJouets) pour que vous 
+puissiez intégrer ces [jouets](./Jouets.md) dans vos univers
+abscons. *Fork and enjoy.*
 
 ## TODO
 
 - bien revoir la hiérarchie des includes
 - définir un jeu de textures cohérent
+- trouver les maths pour faire tourner les roues
+-