diff --git a/README.md b/README.md
index 3eaf074..1399245 100644
--- a/README.md
+++ b/README.md
@@ -15,7 +15,7 @@ pour les codeurs.
 Le service après-vente est (plus ou moins bien) assuré sur
 la [mailing list](https://lists.tetalab.org/mailman/listinfo/tetalab) et/ou
 le canal IRC #tetalab sur le réseau de 
-[Freenode](https://webchat.freenode.net/)...
+[Libera.Chat](https://libera.chat/)...
 
 Par ailleurs, d'autres expérimentations sont
 [en cours](http://la.buvette.org/photos/cumul/fonderie/vidz.html#interpolator)
diff --git a/doc/mkgraf.sh b/doc/mkgraf.sh
index c8c1612..fa549ad 100644
--- a/doc/mkgraf.sh
+++ b/doc/mkgraf.sh
@@ -1,7 +1,14 @@
 #!/bin/bash
 
+#
+#	this script generate some picz for the PDF documentation
+#	and was called by mkdoc.sh
+#
+
 PI=" 3.141592654 "
 
+#	---------------------------------------------------
+
 OUT="cos01.tex"
 
 gnuplot << __EOF__
@@ -24,6 +31,8 @@ __EOF__
 
 wc $OUT
 
+#	---------------------------------------------------
+
 OUT="cos010.tex"
 
 gnuplot << __EOF__
@@ -45,3 +54,5 @@ plot					\
 __EOF__
 
 wc $OUT
+
+#	---------------------------------------------------
diff --git a/experiment/README.md b/experiment/README.md
index 71d5d57..789c40d 100644
--- a/experiment/README.md
+++ b/experiment/README.md
@@ -1,6 +1,12 @@
-# EXPÉRIMENTATION ÀLC
+# EXPÉRIMENTATIONS ÀLC
 
-## ASSEMBLAGE
+Attention, tout ce qui se trouve dans ce répertoire ne sont que des
+essais. Certains aboutissent, et sont migrés vers `funcs/` ou
+`tools/`, d'autre échouent et restent trainer dans le coin en attente
+du retour de l'inspiration.
+
+Le contenu de ce répertoire doit donc être considéré comme
+**volatile**. Si vous y trouvez votre bonheur, il serait sage
+d'en faire une copie personnelle...
 
-## EXTRACTEUR