Graph-Native Infrastructure for Context and Accountable AI Systems
Python agent-memoryaiai-governanceai-infrastructureartificial-intelligencecontext-engineeringcontext-graphsdata-engineeringdecision-intelligencedeveloper-toolsexplainable-aigenerative-aigraph-ragknowledge-graphllmontologyprovenancepythonreasoningsemantic-search
docs(resources): tighten prose across FAQ, learning paths, citation, … (#1456)
Deep Shah478b00243bd0
diff --git a/docs/citation.md b/docs/citation.mdindex d3bb00b9..87b48c8f 100644--- a/docs/citation.md+++ b/docs/citation.md@@ -43,10 +43,10 @@ icon: "quote-left"## Share Your Research-Published research using Semantica? [Let us know](https://github.com/semantica-agi/semantica/issues): we may feature your work.+If you publish research using Semantica, [let us know](https://github.com/semantica-agi/semantica/issues) so we can feature your work.## See Also-- [License](/project-license) — MIT License details.-- [Community](/community) — Connect with the Semantica community.+- [License](/project-license): MIT License details.+- [Community](/community): connect with the Semantica community.diff --git a/docs/faq.md b/docs/faq.mdindex d3537518..6b00d7db 100644--- a/docs/faq.md+++ b/docs/faq.md@@ -27,7 +27,7 @@ icon: "circle-question"<Accordion title="What is Semantica?" icon="info-circle">-Semantica is an open-source framework for building context graphs and decision intelligence layers for AI. It transforms unstructured data: documents, APIs, databases: into structured knowledge graphs with full provenance tracking, making AI systems explainable and auditable.+Semantica is an open-source framework for building context graphs and decision intelligence layers for AI. It transforms unstructured data (documents, APIs, databases) into structured knowledge graphs with full provenance tracking, making AI systems explainable and auditable.It's not a replacement for LangChain or LlamaIndex. It's the **accountability layer** that goes on top: recording decisions, tracing facts to sources, and making reasoning transparent.@@ -46,7 +46,7 @@ It's not a replacement for LangChain or LlamaIndex. It's the **accountability la<Accordion title="What makes Semantica different from LangChain or LlamaIndex?" icon="scale-balanced">-Most frameworks stop at retrieval or generation. Semantica adds an **accountability layer**: every decision is recorded, every fact links to a source, and every reasoning step is explainable. It's designed for environments where you need to audit *why* an AI reached a conclusion: not just what it said.+Most frameworks stop at retrieval or generation. Semantica adds an **accountability layer**: every decision is recorded, every fact links to a source, and every reasoning step is explainable. It's designed for environments where you need to audit *why* an AI reached a conclusion, not just what it said.Semantica works alongside these frameworks, not against them.@@ -54,11 +54,11 @@ Semantica works alongside these frameworks, not against them.<Accordion title="Does Semantica explain an LLM's internal reasoning or chain-of-thought?" icon="triangle-exclamation">-No. This is **system-level explainability, not foundation-model explainability**. Semantica does not expose, reconstruct, or explain what happens *inside* the LLM/foundation model — its internal reasoning or chain-of-thought stays opaque, as it does for any external system.+No. This is **system-level explainability, not foundation-model explainability**. Semantica does not expose, reconstruct, or explain what happens *inside* the LLM/foundation model. Its internal reasoning or chain-of-thought stays opaque, as it does for any external system.What Semantica explains is *outside* the model: what context and data were used, what decision was produced, the provenance behind it, the relevant relationships, the policies applied, and the resulting decision trail.-In short: Semantica explains and audits *what the AI system did* — not the foundation model's private internal reasoning.+In short, Semantica explains and audits *what the AI system did*, not the foundation model's private internal reasoning.</Accordion>@@ -348,6 +348,6 @@ set PYTHONIOENCODING=utf-8## Support-- [Discord](https://discord.gg/sV34vps5hH) — Community chat and live support.-- [GitHub Issues](https://github.com/semantica-agi/semantica/issues) — Bug reports and feature requests.-- [Contributing](/contributing-guide) — Help improve Semantica.+- [Discord](https://discord.gg/sV34vps5hH): community chat and live support.+- [GitHub Issues](https://github.com/semantica-agi/semantica/issues): bug reports and feature requests.+- [Contributing](/contributing-guide): help improve Semantica.diff --git a/docs/learning-more.md b/docs/learning-more.mdindex 7134e98f..6f74d88c 100644--- a/docs/learning-more.md+++ b/docs/learning-more.md@@ -9,9 +9,9 @@ Whether you're running your first pipeline or deploying Semantica in production,## Learning Paths-- **Beginner (1–2 hrs)** — New to Semantica and knowledge graphs. [Start with Installation →](/installation)-- **Intermediate (4–6 hrs)** — Comfortable with basics, building real applications. [Start with Modules →](/modules)-- **Advanced (8+ hrs)** — Enterprise deployments, customization, and extension. [Start with Architecture →](/architecture)+- **Beginner (1–2 hrs)**: new to Semantica and knowledge graphs. [Start with Installation →](/installation)+- **Intermediate (4–6 hrs)**: comfortable with basics, building real applications. [Start with Modules →](/modules)+- **Advanced (8+ hrs)**: enterprise deployments, customization, and extension. [Start with Architecture →](/architecture)<Tabs><Tab title="Beginner (1–2 hrs)">@@ -116,7 +116,7 @@ pip install "semantica[gpu]" # GPU acceleration<Accordion title="AuthenticationError" icon="lock">-Set your API key as an environment variable — never hardcode keys in source files:+Set your API key as an environment variable (never hardcode keys in source files):```bashexport OPENAI_API_KEY="sk-..."@@ -236,6 +236,6 @@ The `blocking_v2`, `hybrid_v2`, and `semantic_v2` strategies reduce O(n²) compa- **Graph exports**: encrypt sensitive exports at rest; use the v0.5.0 SSRF-safe `base_url` validation when configuring custom LLM gateways- **XML ingestion**: always use `XMLIngestor` (v0.5.0), which uses the XXE-safe lxml backend; never parse untrusted XML with the standard library parser-- [Cookbook](/cookbook) — Interactive Jupyter notebooks from beginner to advanced.-- [FAQ](/faq) — Common questions answered.-- [API Reference](/reference/core) — Complete technical documentation.+- [Cookbook](/cookbook): interactive Jupyter notebooks from beginner to advanced.+- [FAQ](/faq): common questions answered.+- [API Reference](/reference/core): complete technical documentation.diff --git a/docs/project-license.md b/docs/project-license.mdindex 284d2eb8..4a26885f 100644--- a/docs/project-license.md+++ b/docs/project-license.md@@ -76,5 +76,5 @@ By contributing to Semantica, you agree that your contributions will be licensed## See Also-- [Contributing](/contributing-guide) — How to contribute to the project.-- [Citation](/citation) — How to cite Semantica in research.+- [Contributing](/contributing-guide): how to contribute to the project.+- [Citation](/citation): how to cite Semantica in research.diff --git a/docs_check.py b/docs_check.pyindex 86095764..43ec33dc 100644--- a/docs_check.py+++ b/docs_check.py@@ -236,7 +236,7 @@ def _() -> list[str]:cwd=DOCS,capture_output=True,text=True,- timeout=300,+ timeout=600,)# Clean up zip regardless of outcomezip_path = os.path.join(DOCS, "export_ci_check.zip")@@ -263,7 +263,7 @@ def _() -> list[str]:except FileNotFoundError:return ["npx not found — skipping Mintlify export check (Node.js required)"]except subprocess.TimeoutExpired:- return ["mintlify export timed out after 300 s"]+ return ["mintlify export timed out after 600 s"]# ── Summary ───────────────────────────────────────────────────────────────────