-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Open
Labels
Description
File: content/manuals/ai/compose/models-and-compose.md
Issue
The "Alternative configuration with provider services" section marks the approach as deprecated but then provides detailed implementation instructions. This creates confusion about whether users should use this approach.
From the file:
Alternative configuration with provider services
[!IMPORTANT]
This approach is deprecated. Use the
modelstop-level element instead.You can also use the
providerservice type, which allows you to declare platform capabilities required by your application.
For AI models, you can use themodeltype to declare model dependencies.To define a model provider:
services: chat: image: my-chat-app depends_on: - ai_runner ai_runner: provider: type: model options: model: ai/smollm2 context-size: 1024 runtime-flags: "--no-prefill-assistant"
Suggested fix
Either:
- Remove this section entirely if the approach is fully deprecated and users shouldn't use it
- If it's still needed for backward compatibility, reduce it to a brief migration notice with a link to migration documentation rather than full usage instructions
- Add context about when it was deprecated and when it will be removed
The current presentation suggests mid-transition documentation that hasn't been fully updated.
Found by nightly documentation freshness scanner
Reactions are currently unavailable