Skip to content

[docs-scanner] Deprecated provider service approach still documented in detail #24256

@docker-agent

Description

@docker-agent

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 models top-level element instead.

You can also use the provider service type, which allows you to declare platform capabilities required by your application.
For AI models, you can use the model type 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:

  1. Remove this section entirely if the approach is fully deprecated and users shouldn't use it
  2. 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
  3. 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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions