Mohd Kaif
a326c7d3bd
Fix/mintlify theme ( #645 )
...
* fix: replace invalid Mintlify theme 'venus' with 'mint'
* docs: replace em dashes with colons across all docs files
* fix: strip UTF-8 BOM from all docs files (broke frontmatter detection)
2026-06-17 13:26:19 +05:30
Mohd Kaif
1f3cea5f0a
docs: upgrade all docs pages with Mintlify premium components ( #642 )
...
Replace plain markdown lists, tables, and numbered steps with interactive
Mintlify v3 MDX components across all 50+ documentation files:
- Tabs: provider/parser/method selection guides, citation formats, component details
- Steps: setup flows, pipeline stages, connection initialization
- CardGroup/Card: feature overviews, "what you get" sections, navigation footers
- AccordionGroup: FAQ entries
- Check/Warning/Tip/Note/Info: callouts replacing plain bold text and inline notes
Files improved span the full docs surface: reference modules (context, llms,
kg, reasoning, embeddings, deduplication, provenance, parse, ontology, core,
semantic_extract), integrations (agno, docling, snowflake), graph/vector
store backends (apache_age, pgvector), and top-level guides (contributing,
governance, glossary, citation, community-projects, learning-more).
2026-06-17 12:58:44 +05:30
Sameer6305
c62ff0238a
docs(explorer): align explorer routes, CLI flags, and APIs with implementation
2026-06-16 11:34:14 +05:30
Mohd Kaif
5d70d0c10d
docs: replace Exported Classes import blocks with summary tables (all 25 modules) ( #567 )
...
* docs: replace Exported Classes import blocks with summary tables across all 25 modules
* docs: add method/parameter tables to parse, ingest, ontology, normalize, triplet_store, change_management, conflicts, export, graph_store, provenance, and semantic_extract modules
2026-05-24 15:49:58 +05:30
KaifAhmad1
68fcff5b3a
docs: add Exported Classes blocks to all remaining reference docs
...
Adds ## Exported Classes (or equivalent interface block) to:
- change_management.md, conflicts.md, context.md, embeddings.md
- graph_store.md, ingest.md, normalize.md, pipeline.md
- seed.md, split.md, triplet_store.md, vector_store.md
- visualization.md
Adds ## Launch Interface to explorer.md (CLI-only module).
Adds ## Server Interface to mcp_server.md (stdio process, not importable).
All blocks sourced from module __all__ with inline usage hints.
evals.md intentionally skipped (placeholder, __all__ = []).
2026-05-24 14:56:11 +05:30
KaifAhmad1
6f726c708f
fix: remove non-existent classes and fix wrong API signatures across reference docs
...
- visualization.md: GraphVisualizer → KGVisualizer; fix method names (visualize_network,
visualize_network_evolution, visualize_snapshot_comparison, visualize_temporal_patterns,
visualize_2d_projection); remove DistanceVisualizer tab; fix start_explorer() reference
- kg.md: remove TemporalKnowledgeGraph and DistanceCalculator (don't exist); replace with
TemporalGraphQuery and ConnectivityAnalyzer; fix query_at_time() signature
- ontology.md: remove OntologyManager, SKOSVocabulary, OntologyAligner, OntologyDiff,
OntologyMigrator (none exist); fix SHACLValidator → OntologyValidator; fix OWLExporter
→ OWLGenerator.export_owl(); fix start_explorer() reference
- evals.md: replace entire file with coming-soon notice (module is a stub, __all__ = [])
- embeddings.md: fix EmbeddingGenerator constructor (takes config dict not model=);
generate() → generate_embeddings(); similarity() → compare_embeddings()
- ingest.md: fix WebIngestor (rate_limit → delay, ingest() → ingest_url());
FeedIngestor (ingest() → ingest_feed(), monitor() → monitor_feeds());
StreamIngestor (backend= constructor → ingest_kafka/rabbitmq/kinesis/pulsar());
DBIngestor constructor + ingest() → ingest_database(); SnowflakeIngestor.ingest() →
ingest_query()/ingest_table(); OntologyIngestor.ingest() → ingest_ontology();
DataSource → FileObject
- explorer.md: remove start_explorer() Python function (only CLI exists);
replace with semantica-explorer CLI usage
- provenance.md: ActivityTracker → ProvenanceTracker in CardGroup
- semantic_extract.md: EventExtractor → EventDetector
- triplet_store.md: remove InMemoryTripletStore (doesn't exist); fix tip
- llms.md: fix providers (Anthropic/Gemini/Ollama/DeepSeek/NovitaAI → LiteLLM);
HuggingFace → HuggingFaceLLM; remove create_provider()
2026-05-24 13:11:57 +05:30
KaifAhmad1
5eefadaa7f
docs: apply full Mintlify component overhaul to all 27 reference pages and concepts.md
...
Replace plain markdown in every docs/reference/ file and docs/concepts.md with
rich Mintlify JSX components — CardGroup, Steps, Tabs, AccordionGroup, Tip,
Warning, Note, and CodeGroup — for a consistent, navigable, production-grade
developer experience.
2026-05-23 23:02:03 +05:30
KaifAhmad1
51b1e7fffd
docs: add 'What You Get' sections to explorer, llms, and mcp_server
2026-05-23 13:17:36 +05:30
KaifAhmad1
9113ef3428
docs: premium overhaul of all reference pages and core docs
...
- Rewrote all 26 reference module pages: removed blockquote taglines and
horizontal rule separators, added "What You Get" bullet summaries,
added constructor/method parameter tables, expanded thin files
(graph_store, triplet_store, visualization, provenance) with full API
coverage, added backend comparison tables and real-world usage patterns
- Renamed Modules tab from "API Reference" and group from "Context &
Knowledge" to "Context & Intelligence" in docs.json
- Fixed logo: copied "Semantica Logo.png" to web-safe semantica-logo.png
and updated all 4 references in docs.json
- Improved core docs (index, modules, concepts, quickstart, installation,
getting-started) with better fonts, bullet points, and complete module
listings (mcp_server, evals, core, utils previously missing)
- Rewrote community pages (community, community-projects, contributing-guide,
use-cases, architecture, faq, learning-more, glossary) with heading
hierarchy fixes, expanded definitions, and better structure
- Fixed markdown linter warnings: MD036 bold-as-heading, MD001 heading
skips, MD040 missing code fence language, MD032 blank lines around lists
2026-05-23 13:10:09 +05:30
KaifAhmad1
ff2d89dc2d
docs: fix broken extension point and explorer examples
...
- architecture.md: replace non-existent BaseIngestor/BaseExtractor/BasePlugin/PluginRegistry.register with correct APIs (method_registry.register, PluginRegistry.register_plugin); fix Python 3.8-incompatible list[dict] type hints
- reference/explorer.md: replace non-existent start_explorer import and graph.save() with correct subprocess launch and graph.save_to_file()
2026-05-22 22:10:11 +05:30
KaifAhmad1 and Claude Sonnet 4.6
946a1089c8
docs: premium redesign — Mintlify v4, dark/cream theme, full module coverage
...
- Migrate from mint.json to docs.json (Mintlify v4)
- Theme: maple, emerald green + near-black dark / cream light palette
(#059669 primary, #0A0A0A dark bg, #FAF7F0 light bg)
- Typography: Lexend headings, Inter body
- 5-tab navigation: Documentation, Quick Start, API Reference, Cookbook, FAQ
- Homepage: removed badge stickers, redundant h2, added blockquote tagline,
full 27-module reference table with semantica.mcp_server added
- quickstart.md: CodeGroup per pipeline step, pattern vs LLM options,
AccordionGroup for patterns and troubleshooting
- faq.md: full AccordionGroup structure across 5 sections
- reference/explorer.md: NEW — FastAPI explorer, Ontology Hub, Distance
Intelligence, CLI reference, REST API endpoints
- reference/mcp_server.md: NEW — MCP stdio server, 12 tools with I/O
examples, 3 resources, Claude Desktop/VS Code/Windsurf/Cline config
- docs.json: explorer added to Output group, mcp_server to Utilities group
- Chat, feedback (thumbs/suggest/raise), OG/Twitter metadata, search topbar
- All reference pages reformatted with Mintlify JSX components
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-05-22 21:52:50 +05:30
Mohd Kaif