semantica/docs/governance.md at 1f3cea5f0a4d1006df8c50a389e85550ee3ce03a

mirror of https://github.com/semantica-agi/semantica.git synced 2026-08-29 04:26:20 +00:00

Files

T

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

3.7 KiB

Raw Blame History

title, description, icon

title	description	icon
Governance	Project governance model — roles, decision process, release cadence, and code review guidelines.	scale-balanced

Semantica is maintained by Hawksight AI with community contributions under an open governance model.

Roles

Hawksight AI team — review and merge PRs, manage releases and code quality, set project direction and community standards. Submit code, documentation, and bug reports. Help with issues and reviews. Recognized in [CONTRIBUTORS.md](https://github.com/semantica-agi/semantica/blob/main/CONTRIBUTORS.md). Use Semantica, provide feedback, share use cases, and participate in GitHub Discussions and Discord.

Decision Process

Code Changes

Open a GitHub Issue describing the change. Community discussion on approach and scope. Submit a pull request with the change. At least one maintainer reviews the PR. Merged after CI passes and maintainer approval.

Major Decisions

RFC posted in GitHub Issues
Minimum 1-week community discussion period
Maintainers decide based on community feedback and technical feasibility

Releases

Semantica follows Semantic Versioning (MAJOR.MINOR.PATCH):

Level	Trigger	Cadence
MAJOR	Breaking changes	Quarterly or as needed
MINOR	New features (backward compatible)	Monthly or when ready
PATCH	Bug fixes (backward compatible)	As bugs are fixed

Code Review

Review criteria: functionality, code quality, tests, documentation, performance, security.

Timeline: initial review within 48 hours; follow-up within 7 days.

Guidelines for reviewers: be constructive, explain reasoning, suggest alternatives.

Guidelines for contributors: address comments promptly, ask questions when unclear, be open to feedback.

Communication

GitHub Issues — bug reports, feature requests, questions
GitHub PRs — code contributions
GitHub Discussions — community conversation
Security Advisories — report security issues privately

Project Goals

Easy to use and understand — sensible defaults, clear documentation, minimal ceremony. Production-ready quality — tested across Python versions, platforms, and real-world workloads. Efficient and scalable — from single-machine notebooks to enterprise graph databases. Easy to extend with plugins and custom modules via the `PluginRegistry` pattern. Welcoming and inclusive — all backgrounds and experience levels contribute and are recognized.

License

MIT License — see LICENSE and the License page.

3.7 KiB Raw Blame History