From 22f4c93c61091a0b83bdbb737061aa73ed45f018 Mon Sep 17 00:00:00 2001 From: gwen Date: Sun, 30 Aug 2026 19:51:57 +0200 Subject: [PATCH] doc --- .gitignore | 8 ++++++++ doc/{ChoixLll.md => ChoixLllm.md} | 0 doc/Experiments.md | 4 ++-- doc/Tasks.md | 9 +++++++++ doc/index.md | 11 +++++++---- experiments/Experiments.md | 9 +++++++++ taskfile.yml | 32 +++++++++++++++++++++++++++++++ 7 files changed, 67 insertions(+), 6 deletions(-) create mode 100644 .gitignore rename doc/{ChoixLll.md => ChoixLllm.md} (100%) create mode 100644 doc/Tasks.md create mode 100644 experiments/Experiments.md create mode 100644 taskfile.yml diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..1945a93 --- /dev/null +++ b/.gitignore @@ -0,0 +1,8 @@ +.venv/ +autocommit.py +requirements.txt.* +mkdocs.yml +overrides +bribes +site/ +.obsidian diff --git a/doc/ChoixLll.md b/doc/ChoixLllm.md similarity index 100% rename from doc/ChoixLll.md rename to doc/ChoixLllm.md diff --git a/doc/Experiments.md b/doc/Experiments.md index 057506b..bbb58d8 100644 --- a/doc/Experiments.md +++ b/doc/Experiments.md @@ -4,8 +4,8 @@ - L'outil utilisé pour les expériences est ollama - Le LLM utilisé pour les expériences est deepseek-r1:7b. -P -ourquoi un reasoning model ? Pour voir les "inner thoughts" du model. + +Pourquoi un reasoning model ? Pour voir les "inner thoughts" du model. Pour voir s'il "comprend" correctement la question. On passera à un truc plus léger ultérieurement. diff --git a/doc/Tasks.md b/doc/Tasks.md new file mode 100644 index 0000000..b0145e9 --- /dev/null +++ b/doc/Tasks.md @@ -0,0 +1,9 @@ +# Tasks + +## Structured output + +Ne renvoyer **que** la variable recherchée, par exemple +`manual.https_proxy.address`, ou bien le nom de la famille +et la liste des variables dedans + +Utiliser un schéma pydantic avec du structured output dessus. diff --git a/doc/index.md b/doc/index.md index 47e6afe..9cb5ddc 100644 --- a/doc/index.md +++ b/doc/index.md @@ -1,9 +1,12 @@ # Rougail AI +## todo + +- [[Tasks]] + +## content + - [[Experiments]] -- [[ChoixLll]] +- [[ChoixLllm]] - [[ChoixLllQuery]] - [[Tools.md]] - - - diff --git a/experiments/Experiments.md b/experiments/Experiments.md new file mode 100644 index 0000000..2945770 --- /dev/null +++ b/experiments/Experiments.md @@ -0,0 +1,9 @@ +## Liste des expériences + +- trouver une variable dans une famille donnée, sachant que la variable + existe dans plusieurs familles +- trouver un nom de famille +- trouver le nom seul + trouver le nom long + exemple: `manual.https_proxy.port`, `port` + diff --git a/taskfile.yml b/taskfile.yml new file mode 100644 index 0000000..5826026 --- /dev/null +++ b/taskfile.yml @@ -0,0 +1,32 @@ +version: '3' + +tasks: + + default: + desc: Exécute build puis publish + cmds: + - task: build + - task: publish + + build: + desc: Génère le site statique avec MkDocs + cmds: + - printf ".. mkdocs build" + - mkdocs build + generates: + - site + + publish: + desc: Publie le site + cmds: + - printf ".. publication du site html" + - rsync -avH --force --stats ./site/* ../../../site/static/bribes/rougailai/ + - ./autocommit.py + + clean: + desc: Supprime les fichiers générés + cmds: + - echo ".. suppression du site html" + - rm -rf {{.GENERATES}} + sources: + - site