Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Move Client Documentation to /integrations/ #1190

Closed
wants to merge 6 commits into from

Conversation

devin-ai-integration[bot]
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot commented Nov 17, 2024

Move Client Documentation to /integrations/

This PR moves all client documentation from /hub/clients/ to /integrations/ and implements comprehensive documentation updates.

Changes

  • Move all client documentation to /integrations/ directory
  • Update mkdocs.yml navigation structure
  • Add comprehensive test files for client examples
  • Document streaming limitations for each client
  • Add .env.tests for tracking required API keys
  • Clean up old client documentation files

Documentation Updates

  • SEO-optimized pages for all clients
  • Standardized titles: "Structured outputs with [client], a complete guide w/ instructor"
  • Each page includes:
    • Async and sync implementations
    • Simple user example
    • Nested example
    • Partial streaming example (where supported)
    • Iterable example
    • Instructor hooks documentation

Streaming Support Documentation

  • Full Support: Anthropic, OpenAI, Anyscale
  • Limited Support: Fireworks, LiteLLM
  • No Support: Cohere, Cerebras

Testing

  • Added test files for all client examples
  • Implemented streaming verification tests
  • Documented test results and limitations

Link to Devin run: https://preview.devin.ai/devin/89a9e436607c4cbea0bf1a301d3168a5

If you have any feedback, you can leave comments in the PR and I'll address them in the app!

- Move all client docs from /hub/clients/ to /integrations/
- Update mkdocs.yml navigation structure
- Add test files for client examples
- Document streaming limitations
- Add .env.tests for missing API keys
- Clean up old client documentation files

Link to Devin run: https://preview.devin.ai/devin/89a9e436607c4cbea0bf1a301d3168a5
- Add llama wrapper for testing
- Add setup.py for test dependencies
- Improve error handling in Fireworks client
Copy link

cloudflare-workers-and-pages bot commented Nov 17, 2024

Deploying instructor-py with  Cloudflare Pages  Cloudflare Pages

Latest commit: e6d4921
Status: ✅  Deploy successful!
Preview URL: https://0caa854f.instructor-py.pages.dev
Branch Preview URL: https://docs-move-to-integrations.instructor-py.pages.dev

View logs

@github-actions github-actions bot added documentation Improvements or additions to documentation enhancement New feature or request size:L This PR changes 100-499 lines, ignoring generated files. labels Nov 17, 2024
@jxnl jxnl requested review from ivanleomk and jxnl November 17, 2024 22:37
- Remove unused imports
- Update type annotations to modern syntax
- Replace assert False with raise AssertionError
- Use _ for unused loop variables
@@ -0,0 +1,12 @@
# Client Streaming Support Matrix
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

delete this

test_results.md Outdated
@@ -0,0 +1,42 @@
# Instructor Integration Test Results
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

delete this

@@ -0,0 +1,66 @@
import os
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

dont include any of the test_clients files

- Remove test_clients directory as requested
- Remove test_results.md and streaming_support.md
- Focus PR on documentation changes only
- Remove llama_wrapper.py (test infrastructure)
- Remove setup.py (test dependencies)
- Remove .env.tests
- Restore client_fireworks.py to main version
- Keep only documentation changes
Copy link
Collaborator

@jxnl jxnl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please make sure all the tieles and files are set correctly

mkdocs.yml Outdated
@@ -209,6 +201,21 @@ nav:
- Generating Knowledge Graphs with Structured Outputs: 'hub/knowledge_graph.md'
- Extracting Relevant Clips from YouTube Videos: "hub/youtube_clips.md"
- Building Knowledge Graphs with Structured Outputs: 'tutorials/5-knowledge-graphs.ipynb'
- Integrations:
- Structured outputs with Anyscale: 'integrations/anyscale.md'
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

just make this "Anthropic" and remove the structured output refereces
set the title in the md file

- Structured Outputs with Anyscale: 'hub/anyscale.md'
- Structured Outputs with Groq: 'hub/groq.md'
- Structured Outputs with Mistral: 'hub/mistral.md'
- Structured Outputs with Cohere: 'hub/cohere.md'
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

create a redirect map for the deleted stuff, using the mkdocs redirect map features


## Updates and Compatibility

Instructor maintains compatibility with Vertex AI's latest API versions. Check the [changelog](../../CHANGELOG.md) for updates.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove all references to change log

- Document Analysis
- Configuration Generation

## Troubleshooting
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove all trouble shotting examples in all docs

…itles and add redirect maps

- Remove troubleshooting sections from all integration docs
- Remove 'Structured outputs with' prefix from navigation titles
- Add redirect maps for moved documentation pages
- Clean up documentation structure
@jxnl jxnl closed this Nov 19, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation enhancement New feature or request size:L This PR changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant