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: refine onboarding guidance and reduce duplication
Sameer6305b09d60161d2c
diff --git a/docs/getting-started.md b/docs/getting-started.mdindex 4f1e3b3b..1bd8dd7f 100644--- a/docs/getting-started.md+++ b/docs/getting-started.md@@ -5,7 +5,7 @@ icon: "rocket"---<Tip>- Just here for code? Jump straight to the [Quickstart Tutorial](quickstart) or explore the [Cookbook](cookbook) for interactive notebooks.+ Already installed? Jump to the [Quickstart Tutorial](quickstart). Need setup help first? Start with [Installation](installation).</Tip>---@@ -35,11 +35,7 @@ icon: "rocket"pip install semantica```-With all optional dependencies:--```bash-pip install semantica[all]-```+For virtual environments, extras, and platform-specific setup, see the full [Installation guide](installation).Verify:diff --git a/docs/index.md b/docs/index.mdindex bdd3b327..b466fb2a 100644--- a/docs/index.md+++ b/docs/index.md@@ -181,18 +181,20 @@ pip install semantica==0.5.0## Start Here+If you're new to Semantica, install first and then open Quickstart. Use Core Concepts or API Reference when you need more context or exact details.+<CardGroup cols={2}><Card title="Quickstart" icon="rocket" href="quickstart">Build a complete knowledge graph pipeline in 5 minutes.</Card><Card title="Core Concepts" icon="book-open" href="concepts">- Knowledge graphs, ontologies, and semantic reasoning explained.+ Use this for the mental model behind the API.</Card><Card title="API Reference" icon="rectangle-terminal" href="reference/context">- Full documentation for every module, class, and method.+ Jump here when you need exact module, class, or method details.</Card><Card title="Cookbook" icon="flask" href="cookbook">- 40+ domain-specific notebooks — healthcare, finance, legal, and more.+ Explore domain notebooks once you have the basics working.</Card></CardGroup>diff --git a/docs/installation.md b/docs/installation.mdindex 9946760d..1955d9a8 100644--- a/docs/installation.md+++ b/docs/installation.md@@ -12,6 +12,10 @@ icon: "download"Python 3.8 or higher required. Python 3.11+ recommended.</Note>+<Tip>+ Once you're set up, read [Getting Started](getting-started) for the overview and [Quickstart](quickstart) for the end-to-end pipeline.+</Tip>+---## Basic Installation@@ -177,13 +181,13 @@ Install the [Microsoft Visual C++ Redistributable](https://aka.ms/vs/17/release/## Next Steps<CardGroup cols={3}>- <Card title="Getting Started" icon="rocket" href="getting-started">- Build your first knowledge graph.+ <Card title="Read the Overview" icon="rocket" href="getting-started">+ Understand what Semantica does before you build.</Card>- <Card title="Quickstart Tutorial" icon="play" href="quickstart">- Full step-by-step pipeline.+ <Card title="Build the Pipeline" icon="play" href="quickstart">+ Follow the end-to-end workflow with code.</Card>- <Card title="Cookbook" icon="flask" href="cookbook">- Interactive Jupyter notebooks.+ <Card title="Browse Examples" icon="flask" href="cookbook">+ See notebook examples organized by use case.</Card></CardGroup>diff --git a/docs/quickstart.md b/docs/quickstart.mdindex b8a7121d..45199cc6 100644--- a/docs/quickstart.md+++ b/docs/quickstart.md@@ -8,7 +8,7 @@ icon: "rocket"**v0.5.0** — Ontology Hub, Distance Intelligence, Parquet & XML ingestion, 12 security fixes. [What's new →](index#whats-new)</Info>-This guide walks you through a complete Semantica pipeline — from raw document to queryable knowledge graph with full provenance. You need Python 3.8+ and nothing else to start. An LLM API key is optional; pattern-based extraction works out of the box.+Use this after installation. If you still need setup help, start with the [Installation guide](installation). You need Python 3.8+ and nothing else to start. An LLM API key is optional; pattern-based extraction works out of the box.---