socle-commun · Mistifiou · Jun 10, 2025 · Jun 10, 2025
diff --git a/docs/README.md b/docs/README.md
@@ -3,3 +3,7 @@
 This folder stores the project's long-term memory.
 Keep pages concise and update them whenever the code changes.
 Link documents to each other so topics remain easy to explore.
+
+See [index](index.md) for the main chapters and consult `docs/buffer.md` for any
+temporary notes. The [knowledge ethics](knowledge-ethics.md) page lists guiding
+principles for trustworthy content.
diff --git a/docs/index.md b/docs/index.md
@@ -1,9 +1,11 @@
 # Welcome
 
-This documentation provides the vision for the Codex Brutal template and the rules the agent must follow.
+This documentation outlines the vision for the Codex Brutal template and the rules the agent must follow.
 
 - [Knowledge Ethics](./knowledge-ethics.md)
 - [VitePress](./vitepress.md)
 - [Roadmap](./roadmap.md)
 
+For an overview of all files see [README](README.md). Feedback and improvements are encouraged so every chapter stays current.
+
 The GitHub Pages site displays this page as the home page.
diff --git a/docs/knowledge-ethics.md b/docs/knowledge-ethics.md
@@ -16,3 +16,4 @@ This document adapts the French **"Manifeste pour l'éthique de la connaissance"
 10. **Commitment to improvement** – Practices evolve continually to uphold these ethical standards.
 
 By following these guidelines, the project promotes an environment where code, data and ideas can be trusted and built upon by the community.
+Return to this list whenever documentation is revised so improvements remain aligned with these principles.
diff --git a/docs/roadmap.md b/docs/roadmap.md
@@ -13,3 +13,5 @@ This document tracks the main steps planned to evolve the template.
 ## Long-term goals
 - Turn this prototype into a full platform usable by various AI agents.
 - Extend test coverage and documentation to ease external contributions.
+
+This roadmap evolves with feedback from contributors and testing results. Review it often to track progress.
diff --git a/docs/vitepress.md b/docs/vitepress.md
@@ -17,3 +17,5 @@ npm install vitepress --save-dev
 - Markdown support and live component preview
 - HMR via Vite
 - Customizable static site generation
+
+Refer to the [VitePress docs](https://vitepress.vuejs.org/) for advanced setup options.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -16,3 +16,4 @@ This document adapts the French **"Manifeste pour l'éthique de la connaissance"
		10. Commitment to improvement – Practices evolve continually to uphold these ethical standards.

		By following these guidelines, the project promotes an environment where code, data and ideas can be trusted and built upon by the community.
		Return to this list whenever documentation is revised so improvements remain aligned with these principles.