Skip to content

Graph-Native Infrastructure for Context and Accountable AI Systems

docs: tighten prose in community and governance pages (#1442)

Deep Shah4568aeba2c00
diff --git a/docs/community.md b/docs/community.md
index 8c7d4e28..6d25fdf7 100644
--- a/docs/community.md
+++ b/docs/community.md
@@ -9,10 +9,10 @@ Semantica is built in the open, with contributions from researchers, engineers,
## Get Help
-- [GitHub Issues](https://github.com/semantica-agi/semantica/issues) — File bug reports and feature requests with full context.
-- [GitHub Discussions](https://github.com/semantica-agi/semantica/discussions) — Ask questions, share ideas, and discuss design decisions.
-- [Pull Requests](https://github.com/semantica-agi/semantica/pulls) — Browse open contributions and submit your own.
-- [Security Issues](https://github.com/semantica-agi/semantica/security/advisories/new) — Report vulnerabilities privately: never in public issues.
+- [GitHub Issues](https://github.com/semantica-agi/semantica/issues): file bug reports and feature requests with full context.
+- [GitHub Discussions](https://github.com/semantica-agi/semantica/discussions): ask questions, share ideas, and discuss design decisions.
+- [Pull Requests](https://github.com/semantica-agi/semantica/pulls): browse open contributions and submit your own.
+- [Security Issues](https://github.com/semantica-agi/semantica/security/advisories/new): report vulnerabilities privately (never in public issues).
## Community Guidelines
@@ -68,7 +68,7 @@ See the [Contributing Guide](/contributing-guide) for the full development workf
## See Also
-- [Contributing Guide](/contributing-guide) — Step-by-step guide for submitting PRs and setting up your dev environment.
-- [Community Projects](/community-projects) — Projects and integrations built by the community.
-- [FAQ](/faq) — Common questions answered.
-- [Governance](/governance) — How the project is run and decisions are made.
+- [Contributing Guide](/contributing-guide): step-by-step guide for submitting PRs and setting up your dev environment.
+- [Community Projects](/community-projects): projects and integrations built by the community.
+- [FAQ](/faq): common questions answered.
+- [Governance](/governance): how the project is run and decisions are made.
diff --git a/docs/governance.md b/docs/governance.md
index 61ab29dc..8fa78d0a 100644
--- a/docs/governance.md
+++ b/docs/governance.md
@@ -9,9 +9,9 @@ icon: "scale-balanced"
## Roles
-- **Maintainers** — Semantica team: review and merge PRs, manage releases and code quality, set project direction and community standards.
-- **Contributors** — 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).
-- **Community Members** — Use Semantica, provide feedback, share use cases, and participate in GitHub Discussions and Discord.
+- **Maintainers**: Semantica team. Review and merge PRs, manage releases and code quality, set project direction and community standards.
+- **Contributors**: 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).
+- **Community Members**: use Semantica, provide feedback, share use cases, and participate in GitHub Discussions and Discord.
## Decision Process
@@ -65,11 +65,11 @@ Semantica follows **Semantic Versioning** (`MAJOR.MINOR.PATCH`):
## Project Goals
-- **Usability** — Easy to use and understand: sensible defaults, clear documentation, minimal ceremony.
-- **Reliability** — Production-ready quality: tested across Python versions, platforms, and real-world workloads.
-- **Performance** — Efficient and scalable: from single-machine notebooks to enterprise graph databases.
-- **Extensibility** — Easy to extend with plugins and custom modules via the `PluginRegistry` pattern.
-- **Community** — Welcoming and inclusive: all backgrounds and experience levels contribute and are recognized.
+- **Usability**: easy to use and understand with sensible defaults, clear documentation, and minimal ceremony.
+- **Reliability**: production-ready quality tested across Python versions, platforms, and real-world workloads.
+- **Performance**: efficient and scalable from single-machine notebooks to enterprise graph databases.
+- **Extensibility**: easy to extend with plugins and custom modules via the `PluginRegistry` pattern.
+- **Community**: welcoming and inclusive. All backgrounds and experience levels contribute and are recognized.
## License
@@ -79,5 +79,5 @@ MIT License: see [LICENSE](https://github.com/semantica-agi/semantica/blob/main/
## See Also
-- [Contributing](/contributing-guide) — How to submit changes.
-- [Community](/community) — Community guidelines and channels.
+- [Contributing](/contributing-guide): how to submit changes.
+- [Community](/community): community guidelines and channels.