SynaLinks · YoanSallami · Aug 21, 2026 · Aug 21, 2026 · Aug 21, 2026
diff --git a/docs/Code Examples/Autonomous Agent.md b/docs/Code Examples/Autonomous Agent.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/10_autonomous_agent.py:108"
+--8<-- "examples/10_autonomous_agent.py:108"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Conditional Branches.md b/docs/Code Examples/Conditional Branches.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/4_conditional_branches.py:129"
+--8<-- "examples/4_conditional_branches.py:129"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Conversational Applications.md b/docs/Code Examples/Conversational Applications.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/6_conversational_applications.py:83"
+--8<-- "examples/6_conversational_applications.py:83"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Cypher Agent.md b/docs/Code Examples/Cypher Agent.md
@@ -7,7 +7,7 @@
 ## Source
 
 ````python
---8 < --"examples/23_cypher_agent.py:source"
+--8<-- "examples/23_cypher_agent.py:source"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Data Model Operators.md b/docs/Code Examples/Data Model Operators.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/5a_data_model_operators.py:168"
+--8<-- "examples/5a_data_model_operators.py:168"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Decisions.md b/docs/Code Examples/Decisions.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/3_decisions.py:120"
+--8<-- "examples/3_decisions.py:120"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Deep Agent.md b/docs/Code Examples/Deep Agent.md
@@ -7,7 +7,7 @@
 ## Source
 
 ````python
---8 < --"examples/20_deep_agent.py:source"
+--8<-- "examples/20_deep_agent.py:source"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Document RAG.md b/docs/Code Examples/Document RAG.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/13_document_rag.py:89"
+--8<-- "examples/13_document_rag.py:89"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/First Steps.md b/docs/Code Examples/First Steps.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/0_first_steps.py:135"
+--8<-- "examples/0_first_steps.py:135"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Functional API.md b/docs/Code Examples/Functional API.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/1a_functional_api.py:127"
+--8<-- "examples/1a_functional_api.py:127"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Implementing Custom Modules Via Subclassing.md b/docs/Code Examples/Implementing Custom Modules Via Subclassing.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/9_custom_modules.py:132"
+--8<-- "examples/9_custom_modules.py:132"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Interactive Agent.md b/docs/Code Examples/Interactive Agent.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/11_interactive_agent.py:132"
+--8<-- "examples/11_interactive_agent.py:132"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/JSON Ops.md b/docs/Code Examples/JSON Ops.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/5b_json_ops.py:121"
+--8<-- "examples/5b_json_ops.py:121"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Knowledge Extraction and Storage.md b/docs/Code Examples/Knowledge Extraction and Storage.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/12_knowledge_extraction_and_storage.py:110"
+--8<-- "examples/12_knowledge_extraction_and_storage.py:110"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/MCP Agent.md b/docs/Code Examples/MCP Agent.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/15_mcp_agent.py:100"
+--8<-- "examples/15_mcp_agent.py:100"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Mixing Strategy.md b/docs/Code Examples/Mixing Strategy.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/1d_mixing_strategy.py:159"
+--8<-- "examples/1d_mixing_strategy.py:159"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Parallel Branches.md b/docs/Code Examples/Parallel Branches.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/2_parallel_branches.py:128"
+--8<-- "examples/2_parallel_branches.py:128"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Python Synthesis.md b/docs/Code Examples/Python Synthesis.md
@@ -7,5 +7,5 @@
 ## Source
 
 ````python
---8 < --"examples/22_python_synthesis.py:source"
+--8<-- "examples/22_python_synthesis.py:source"
 ````
diff --git a/docs/Code Examples/Recursive Language Model Agent.md b/docs/Code Examples/Recursive Language Model Agent.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/17_recursive_language_model_agent.py:128"
+--8<-- "examples/17_recursive_language_model_agent.py:128"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Reward Metrics And Optimizers.md b/docs/Code Examples/Reward Metrics And Optimizers.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/7_reward_metrics_and_optimizers.py:84"
+--8<-- "examples/7_reward_metrics_and_optimizers.py:84"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/SQL Agent.md b/docs/Code Examples/SQL Agent.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/16_sql_agent.py:source"
+--8<-- "examples/16_sql_agent.py:source"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Sequential API.md b/docs/Code Examples/Sequential API.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/1c_sequential.py:109"
+--8<-- "examples/1c_sequential.py:109"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Subclassing.md b/docs/Code Examples/Subclassing.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"examples/1b_subclassing.py:158"
+--8<-- "examples/1b_subclassing.py:158"
 ````
 
 ## Run log

diff --git a/docs/Code Examples/Training Programs.md b/docs/Code Examples/Training Programs.md
@@ -8,5 +8,5 @@
 ## Source
 
 ````python
---8 < --"examples/8_training_programs.py:95"
+--8<-- "examples/8_training_programs.py:95"
 ````
diff --git a/docs/Code Examples/Vector RAG Agent.md b/docs/Code Examples/Vector RAG Agent.md
@@ -7,7 +7,7 @@
 ## Source
 
 ````python
---8 < --"examples/14_vector_rag_agent.py:source"
+--8<-- "examples/14_vector_rag_agent.py:source"
 ````
 
 ## Run log

diff --git a/docs/Synalinks API/Data Models API/Score Data Models.md b/docs/Synalinks API/Data Models API/Score Data Models.md
@@ -0,0 +1 @@
+::: synalinks.src.backend.pydantic.metrics
diff --git a/docs/Synalinks API/Data Models API/index.md b/docs/Synalinks API/Data Models API/index.md
@@ -16,4 +16,5 @@ Synalinks features four distinct types of data models, each serving a unique pur
 - [The JsonDataModel Class](The JsonDataModel class.md): The backend-independent data models.
 - [The SymbolicDataModel Class](The SymbolicDataModel class.md): The symbolic data models.
 - [The Variable Class](The Variable class.md): The variable data models that the optimizers can act upon.
-- [The Base DataModels](The Base DataModels.md): A collection of basic backend-dependent data models.
+- [The Base DataModels](The Base DataModels.md): A collection of basic backend-dependent data models.
+- [Score Data Models](Score Data Models.md): Discretized score scales (`Score`, `FineScore`, `Rating`, `Rating10`, `Rating20`) the language model can pick from, and the helpers to resolve and normalize them.
diff --git a/docs/guides/Agents.md b/docs/guides/Agents.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"guides/6_agents.py:446"
+--8<-- "guides/6_agents.py:446"
 ````
 
 ## Run log

diff --git a/docs/guides/Callbacks.md b/docs/guides/Callbacks.md
@@ -8,5 +8,5 @@
 ## Source
 
 ````python
---8 < --"guides/16_callbacks.py:401"
+--8<-- "guides/16_callbacks.py:401"
 ````
diff --git a/docs/guides/Consul of Models.md b/docs/guides/Consul of Models.md
@@ -7,7 +7,7 @@
 ## Source
 
 ````python
---8 < --"guides/30_consul_of_models.py:364"
+--8<-- "guides/30_consul_of_models.py:364"
 ````
 
 ## Run log

diff --git a/docs/guides/Control Flow.md b/docs/guides/Control Flow.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"guides/5_control_flow.py:255"
+--8<-- "guides/5_control_flow.py:255"
 ````
 
 ## Run log

diff --git a/docs/guides/Cypher Agent.md b/docs/guides/Cypher Agent.md
@@ -7,7 +7,7 @@
 ## Source
 
 ````python
---8 < --"guides/26_cypher_agent.py:101"
+--8<-- "guides/26_cypher_agent.py:101"
 ````
 
 ## Run log

diff --git a/docs/guides/Data Models.md b/docs/guides/Data Models.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"guides/2_data_models.py:541"
+--8<-- "guides/2_data_models.py:558"
 ````
 
 ## Run log

diff --git a/docs/guides/Datasets.md b/docs/guides/Datasets.md
@@ -8,5 +8,5 @@
 ## Source
 
 ````python
---8 < --"guides/11_datasets.py:435"
+--8<-- "guides/11_datasets.py:435"
 ````
diff --git a/docs/guides/Deep Agent.md b/docs/guides/Deep Agent.md
@@ -7,7 +7,7 @@
 ## Source
 
 ````python
---8 < --"guides/22_deep_agent.py:243"
+--8<-- "guides/22_deep_agent.py:247"
 ````
 
 ## Run log

diff --git a/docs/guides/FastAPI Deployment.md b/docs/guides/FastAPI Deployment.md
@@ -8,5 +8,5 @@
 ## Source
 
 ```python
---8 < --"guides/20_fastapi_deployment.py:source"
+--8<-- "guides/20_fastapi_deployment.py:source"
 ```
diff --git a/docs/guides/FastMCP Deployment.md b/docs/guides/FastMCP Deployment.md
@@ -8,5 +8,5 @@
 ## Source
 
 ```python
---8 < --"guides/21_fastmcp_deployment.py:source"
+--8<-- "guides/21_fastmcp_deployment.py:source"
 ```
diff --git a/docs/guides/Free-form Knowledge Graph Extraction.md b/docs/guides/Free-form Knowledge Graph Extraction.md
@@ -7,7 +7,7 @@
 ## Source
 
 ````python
---8 < --"guides/28_free_form_knowledge_graph_extraction.py:source"
+--8<-- "guides/28_free_form_knowledge_graph_extraction.py:source"
 ````
 
 ## Run log

diff --git a/docs/guides/Getting Started.md b/docs/guides/Getting Started.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"guides/1_getting_started.py:345"
+--8<-- "guides/1_getting_started.py:345"
 ````
 
 ## Run log

diff --git a/docs/guides/GraphRAG.md b/docs/guides/GraphRAG.md
@@ -7,7 +7,7 @@
 ## Source
 
 ````python
---8 < --"guides/32_graphrag.py:source"
+--8<-- "guides/32_graphrag.py:source"
 ````
 
 ## Run log

diff --git a/docs/guides/Hyperparameter Search.md b/docs/guides/Hyperparameter Search.md
@@ -8,5 +8,5 @@
 ## Source
 
 ````python
---8 < --"guides/17_hyperparameter_search.py:351"
+--8<-- "guides/17_hyperparameter_search.py:351"
 ````
diff --git a/docs/guides/Input Guard.md b/docs/guides/Input Guard.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"guides/8_input_guard.py:294"
+--8<-- "guides/8_input_guard.py:294"
 ````
 
 ## Run log

diff --git a/docs/guides/Knowledge Base.md b/docs/guides/Knowledge Base.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"guides/7_knowledge_base.py:source"
+--8<-- "guides/7_knowledge_base.py:source"
 ````
 
 ## Run log

diff --git a/docs/guides/Knowledge Graph Extraction.md b/docs/guides/Knowledge Graph Extraction.md
@@ -7,7 +7,7 @@
 ## Source
 
 ````python
---8 < --"guides/27_knowledge_graph_extraction.py:source"
+--8<-- "guides/27_knowledge_graph_extraction.py:source"
 ````
 
 ## Run log

diff --git a/docs/guides/Metrics.md b/docs/guides/Metrics.md
@@ -8,5 +8,5 @@
 ## Source
 
 ````python
---8 < --"guides/14_metrics.py:345"
+--8<-- "guides/14_metrics.py:345"
 ````
diff --git a/docs/guides/Mixture of Models.md b/docs/guides/Mixture of Models.md
@@ -7,7 +7,7 @@
 ## Source
 
 ````python
---8 < --"guides/29_mixture_of_models.py:396"
+--8<-- "guides/29_mixture_of_models.py:396"
 ````
 
 ## Run log

diff --git a/docs/guides/Modules.md b/docs/guides/Modules.md
@@ -8,7 +8,7 @@
 ## Source
 
 ````python
---8 < --"guides/4_modules.py:635"
+--8<-- "guides/4_modules.py:641"
 ````
 
 ## Run log