Skip to content

Graph-Native Infrastructure for Context and Accountable AI Systems

docs: refine onboarding guidance and reduce duplication

Sameer6305b09d60161d2c
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 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.md
index 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.md
index 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.md
index 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.
---