From ace7adbbddc5940e26f6a90f927bff42dc0387fd Mon Sep 17 00:00:00 2001 From: AutoHarness Bot Date: Thu, 3 Sep 2026 14:59:10 -0400 Subject: [PATCH 1/2] docs(contributing): tighten prose and use developer-first guidance --- docs/community-projects.md | 10 +++++----- docs/contributing-guide.md | 18 +++++++++--------- 2 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/community-projects.md b/docs/community-projects.md index 185189dc..6a1c0436 100644 --- a/docs/community-projects.md +++ b/docs/community-projects.md @@ -67,7 +67,7 @@ Production deployments span regulated and high-stakes industries where AI accoun | **OpenAI** | GPT-4o, GPT-4, GPT-3.5 | | **Anthropic** | Claude Opus, Sonnet, Haiku | | **Google Gemini** |: | - | **Groq** | LLaMA, Mixtral: fast inference | + | **Groq** | LLaMA, Mixtral (fast inference) | | **Ollama** | Fully local, air-gapped | | **HuggingFace** |: | | **DeepSeek** |: | @@ -114,7 +114,7 @@ See [Architecture](/architecture#extension-points) for the full extension guide. ## How to Contribute -- [Contributing Guide](/contributing-guide) — Submit code, documentation, tests, or cookbook notebooks. -- [GitHub Issues](https://github.com/semantica-agi/semantica/issues) — Report bugs, request features, or propose integrations. -- [Discord](https://discord.gg/sV34vps5hH) — Share what you're building with the community. -- [GitHub Discussions](https://github.com/semantica-agi/semantica/discussions) — Long-form questions, design discussions, and ideas. +- [Contributing Guide](/contributing-guide): submit code, documentation, tests, or cookbook notebooks. +- [GitHub Issues](https://github.com/semantica-agi/semantica/issues): report bugs, request features, or propose integrations. +- [Discord](https://discord.gg/sV34vps5hH): share what you're building with the community. +- [GitHub Discussions](https://github.com/semantica-agi/semantica/discussions): long-form questions, design discussions, and ideas. diff --git a/docs/contributing-guide.md b/docs/contributing-guide.md index b5188894..02579ebe 100644 --- a/docs/contributing-guide.md +++ b/docs/contributing-guide.md @@ -4,7 +4,7 @@ description: "How to contribute code, documentation, tests, and community suppor icon: "code-pull-request" --- -Contributions of all kinds are welcome: code, documentation, tests, and community support. Every contribution is recognized in release notes and the GitHub contributors list. +Contributions of all kinds are welcome (code, documentation, tests, and community support). Every contribution is recognized in release notes and the GitHub contributors list. ## Quick Start @@ -17,15 +17,15 @@ pip install -e ".[dev]" pytest ``` -New to the project? Start with [`good-first-issue`](https://github.com/semantica-agi/semantica/labels/good-first-issue) labeled tickets: they're scoped to be completable in a few hours without deep codebase knowledge. +First-time contributors can start with [`good-first-issue`](https://github.com/semantica-agi/semantica/labels/good-first-issue) labeled tickets, which are scoped to be completable in a few hours without deep codebase knowledge. ## Ways to Contribute -- **Code** — Fix bugs, implement features, optimize performance, or add new ingestors, parsers, and exporters using the plugin registry. -- **Documentation** — Fix typos, improve clarity, add missing examples, write tutorials, or keep the API reference accurate as modules evolve. -- **Testing** — Add test coverage for untested modules or edge cases, reproduce reported bugs with minimal repros, or improve cross-platform reliability. -- **Community** — Answer questions in GitHub Issues and Discussions, review pull requests with constructive feedback, or share Semantica in blog posts and talks. +- **Code**: fix bugs, implement features, optimize performance, or add new ingestors, parsers, and exporters using the plugin registry. +- **Documentation**: fix typos, improve clarity, add missing examples, write tutorials, or keep the API reference accurate as modules evolve. +- **Testing**: add test coverage for untested modules or edge cases, reproduce reported bugs with minimal repros, or improve cross-platform reliability. +- **Community**: answer questions in GitHub Issues and Discussions, review pull requests with constructive feedback, or share Semantica in blog posts and talks. ## Development Setup @@ -76,7 +76,7 @@ Before submitting a PR, confirm: ## Code of Conduct -All contributors are expected to follow the [Contributor Covenant Code of Conduct](https://github.com/semantica-agi/semantica/blob/main/CODE_OF_CONDUCT.md). Be respectful, patient, and constructive: especially toward newcomers. Report violations by opening an issue with the `[CoC]` prefix. +All contributors are expected to follow the [Contributor Covenant Code of Conduct](https://github.com/semantica-agi/semantica/blob/main/CODE_OF_CONDUCT.md). Be respectful, patient, and constructive, especially toward newcomers. Report violations by opening an issue with the `[CoC]` prefix. ## Help @@ -85,5 +85,5 @@ All contributors are expected to follow the [Contributor Covenant Code of Conduc - [GitHub Discussions](https://github.com/semantica-agi/semantica/discussions) - [Discord](https://discord.gg/sV34vps5hH) -- [Community](/community) — Community guidelines and values. -- [Governance](/governance) — How decisions are made and the project is run. +- [Community](/community): community guidelines and values. +- [Governance](/governance): how decisions are made and the project is run. From 22fde95d7cdd9c6003bb436831da62ed454ee4af Mon Sep 17 00:00:00 2001 From: KaifAhmad1 Date: Fri, 4 Sep 2026 15:27:01 +0530 Subject: [PATCH 2/2] docs(community-projects): fill in blank LLM provider table cells Google Gemini, HuggingFace, DeepSeek, and Novita AI rows were left as a stray colon with no notes. Fill them in to match the pattern of the other rows, sourced from semantica/semantic_extract/providers.py. --- docs/community-projects.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/community-projects.md b/docs/community-projects.md index 6a1c0436..e2af5e46 100644 --- a/docs/community-projects.md +++ b/docs/community-projects.md @@ -66,12 +66,12 @@ Production deployments span regulated and high-stakes industries where AI accoun | :-------- | :---- | | **OpenAI** | GPT-4o, GPT-4, GPT-3.5 | | **Anthropic** | Claude Opus, Sonnet, Haiku | - | **Google Gemini** |: | + | **Google Gemini** | Gemini Pro and other Gemini models | | **Groq** | LLaMA, Mixtral (fast inference) | | **Ollama** | Fully local, air-gapped | - | **HuggingFace** |: | - | **DeepSeek** |: | - | **Novita AI** |: | + | **HuggingFace** | Transformers-based local LLM models | + | **DeepSeek** | deepseek-chat and reasoning models | + | **Novita AI** | OpenAI-compatible gateway, DeepSeek-V3.2 default | | **LiteLLM** | 100+ model gateway |