Skip to content

Conversation

zastrowm
Copy link
Member

@zastrowm zastrowm commented Oct 3, 2025

Description

Add a top-level Community section in the documentation - the purpose is two-fold:

  1. add a place to add packaging guidelines
  2. showcase community-contributed packages

For (1): Added community/community-packages.md. This includes detailed guidance for creating, publishing, and featuring community packages, along with clear examples and best practices for model providers and tools.

For (2): Community model providers (Cohere, CLOVA Studio) have been moved to a dedicated community/model-providers/ section for better organization.

Note

Clova-studio and Cohere files were moved not rewritten; the diff is slightly misleading; this commit is an easier to understand diff

Notes:

  • Backward Compatibility Workaround: To avoid breaking existing links, I added a redirect mechanism using markdown links combined with JavaScript - we automatically redirect to the new community sections using a custom auto-redirect.js element that handles client-side redirects after a 1-second delay. I did this to let mkdocs generate the correct links while JavaScript does the actual redirection to let people see the change. I didn't use the mkdocs redirect plugin as it has content flashing - I'm banking on the new CMS to avoid this hack.
  • I'm hoping that more content will fill out the community section as we get more contributions.
  • I added cohere as a Community Model Provider even though it uses OpenAI underneath the hood because I feel like we can add additional OpenAI providers like this going forward.

Type of Change

  • New content addition

Screenshots

The screenshots are slightly-of-out-date in that the Community node is now after Examples

image image image

Checklist

  • I have read the CONTRIBUTING document
  • My changes follow the project's documentation style
  • I have tested the documentation locally using mkdocs serve
  • Links in the documentation are valid and working
  • Images/diagrams are properly sized and formatted
  • All new and existing tests pass

Additional Notes

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Move Cohere and Clova Studio documentation from user-guide/concepts/model-providers/
to community/model-providers/ to better organize community-contributed content.
Start building out community docs by adding a new top level community node. Under this node, we have packaging guidelines (new content) + we list out the community-contributed model providers.

To maintain backwards compatibility, we have stub pages for the moved cohere/clova-studio that redirect to the moved pages - this required some weird workaround that I hope to remove once we have a new docs CMS
@zastrowm zastrowm marked this pull request as ready for review October 3, 2025 17:45
@zastrowm zastrowm merged commit ede0785 into strands-agents:main Oct 3, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants