diff --git a/.github/ISSUE_TEMPLATE/integration.md b/.github/ISSUE_TEMPLATE/integration.md new file mode 100644 index 0000000000..416a1c6974 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/integration.md @@ -0,0 +1,27 @@ +--- +name: Integration +about: Propose a community integration, sponsored listing, or paid integration work +title: '[Integration] ' +labels: '' +assignees: '' +--- + +## What would you like to do? +- [ ] Propose or list a community integration (free) +- [ ] Discuss sponsored placement +- [ ] Commission integration development or maintenance + +## Integration +What does it connect to Go Micro, and who is it useful for? + +## Repository and maintainer +Source URL, maintainer/contact, license, and supported Go Micro versions. +For a new proposal, describe what you plan to build. + +## Usage and verification +Link installation instructions, a working example, and integration tests if available. + +## Scope +For sponsorship or paid work, describe the placement or work you need and your timeline. + +Community contributions do not require sponsorship. Sponsorship does not guarantee acceptance into core or maintenance by Micro. Vendor-specific implementations should live in their own repositories. diff --git a/README.md b/README.md index b770a7580a..28a292a19b 100644 --- a/README.md +++ b/README.md @@ -27,6 +27,10 @@ go get go-micro.dev/v6@latest Choose what you need. Chat does not require the gateway. +## Integrations + +[Browse integrations](https://go-micro.dev/integrations.html), [propose one](https://github.com/micro/go-micro/issues/new?template=integration.md), or submit a listing PR. Community listings are free; sponsored placement and integration work help fund maintenance. + ## Documentation - [Index](https://go-micro.dev/docs/) diff --git a/internal/website/content/en/integrations.md b/internal/website/content/en/integrations.md new file mode 100644 index 0000000000..5be3fce9fa --- /dev/null +++ b/internal/website/content/en/integrations.md @@ -0,0 +1,44 @@ +--- +title: Integrations +description: Connect Go Micro to other services and providers, or share your own integration. +type: docs +menu: + main: + weight: 25 +params: + body_class: td-no-left-sidebar + hide_feedback: true +--- + +Connect Go Micro to the systems you use. Vendor-specific plugins can live in their own repositories and implement the framework's interfaces. + +[Propose an integration](https://github.com/micro/go-micro/issues/new?template=integration.md) ยท [Submit a listing PR](https://github.com/micro/go-micro/edit/master/internal/website/content/en/integrations.md) + +## Built into Go Micro + +- [Models](docs/guides/ai-provider-guide.md) โ€” supported providers and configurable endpoints for OpenAI-compatible APIs. +- [MCP](docs/mcp.md) โ€” expose services as tools for other agents. +- [Plugins](docs/plugins.md) โ€” replace registry, broker, transport, storage and other components through Go interfaces. + +## Community integrations + +Community listings are free. Integrations are maintained by their authors; a listing does not mean Micro maintains or endorses the code. + +To add yours, open an issue to discuss it or submit a PR to this page. Include: + +- A short description and a link to the source repository. +- The maintainer, license and supported Go Micro versions. +- Installation instructions and a working example. +- Tests covering its use with Go Micro. + +Keep vendor-specific code in your own repository. General improvements and bug fixes to Go Micro are welcome as ordinary PRs and do not require sponsorship. Listings are reviewed for relevance, clarity and functionality. + +## Sponsored integrations + +Sponsorship funds the framework's maintenance and offers featured placement on this page. Featured listings will be clearly marked **Sponsored**, with the maintainer identified. There are no sponsored listings yet. + +[Open an integration issue](https://github.com/micro/go-micro/issues/new?template=integration.md) to discuss placement, or [sponsor Go Micro](https://github.com/sponsors/micro). Agree the placement and terms before paying; a general sponsorship does not automatically create a listing. + +Sponsorship does not guarantee code acceptance, endorsement or maintenance by Micro. When sponsorship ends, featured placement ends; an eligible community listing can remain. + +Integration development, compatibility testing and ongoing maintenance are available as separately scoped paid work. Use the same issue template to tell us what you need.