docs(readme): finish de-jargoning — headings, feature labels, fix stale name

Carry the "drop semantic jargon" pass through the whole README, not just the
opening:
- "## Why Semantic MCP?" → "## Why It's Different"
- "## The Semantic Advantage" → "## In Practice" (the section is examples;
  the old title also near-duplicated "Why It's Different")
- "### Semantic Search" → "### Full-Text Search" — the section describes
  operators/regex/relevance ranking, i.e. full-text, not embedding-semantic;
  the old label was both jargon and inaccurate
- "Search across all notes semantically" → "Search and rank across all notes"
- "Concept Discovery: Semantic search finds..." → "Search and graph traversal
  surface related ideas..."
- "AI uses semantic tools to:" → "AI uses these tools to:"
- Fix stale settings reference: "Semantic MCP" → "Semantic Notes Vault MCP"
  (the actual manifest name shown in Obsidian's plugin list)

"Semantic" now survives only as the plugin's own name and the
semantic-vault-mcp slug / cert paths — its established identity, unchanged.
This commit is contained in:
Aaron Bockelie 2026-07-03 23:11:03 -05:00
parent 7a7faa84a7
commit f72b460ab2

View file

@ -125,24 +125,24 @@ Once connected, simply chat with your AI assistant about your notes! For example
Your AI assistant now has these capabilities:
- Navigate your vault's link structure
- Search across all notes semantically
- Search and rank across all notes
- Read, edit, and create notes
- Analyze your knowledge graph
- Work with Dataview queries (if installed)
- Manage Obsidian Bases (database views)
## Why Semantic MCP?
## Why It's Different
Traditional file access gives AI a narrow view - one document at a time. This plugin transforms that into **semantic agency**:
Traditional file access gives AI a narrow view — one document at a time. This plugin gives it the whole connected picture:
- **Graph Navigation**: AI follows links between notes, understanding relationships and context
- **Concept Discovery**: Semantic search finds related ideas across your vault
- **Concept Discovery**: Search and graph traversal surface related ideas across your vault
- **Contextual Awareness**: AI understands where information lives in your knowledge structure
- **Intelligent Synthesis**: Combine fragments from multiple notes to answer complex questions
## Core Tools
The plugin provides 8 semantic tool groups that give AI comprehensive vault access:
The plugin provides 8 powerful tools that give AI comprehensive vault access — each one a family of related operations, all subject to the permissions you set:
| Tool | Purpose | Key Actions |
|------|---------|-------------|
@ -167,15 +167,15 @@ Detailed documentation for each tool and feature:
- [🔧 Configuration](docs/configuration.md) - Server settings and options
- [❓ Troubleshooting](docs/troubleshooting.md) - Common issues and solutions
## The Semantic Advantage
## In Practice
This plugin doesn't just give AI access to files - it provides **semantic understanding**:
This plugin doesn't just give AI access to files — it lets AI work across your vault as a connected whole:
### Example: Research Assistant
```
User: "Summarize my research on machine learning optimization"
AI uses semantic tools to:
AI uses these tools to:
1. Search for notes with ML optimization concepts
2. Traverse graph to find related papers and techniques
3. Follow backlinks to discover applications
@ -195,7 +195,7 @@ AI uses graph tools to:
## Features
### Semantic Search
### Full-Text Search
- Advanced query operators: `tag:`, `path:`, `content:`
- Regular expressions and phrase matching
- Relevance ranking and snippet extraction
@ -220,7 +220,7 @@ AI uses graph tools to:
## Plugin Settings
Access settings via: Settings → Community plugins → Semantic MCP
Access settings via: Settings → Community plugins → Semantic Notes Vault MCP
Key configuration options:
- **Server Ports**: HTTP (3001) and HTTPS (3443)