Thanks to visit codestin.com
Credit goes to github.com

Skip to content

[📃 Docs]: inconsistent provider ordering on documentation overview page #5399

@gecube

Description

@gecube

Summary

On the documentation page
👉 https://docs.keephq.dev/providers/overview,
the list of providers appears mostly sorted alphabetically — except for a few anomalies.

For example, FluxCD appears immediately after ArgoCD, which breaks the expected alphabetical order.


🧩 Steps to reproduce

  1. Open https://docs.keephq.dev/providers/overview
  2. Scroll through the list of providers
  3. Observe that:
    • Most entries are sorted alphabetically
    • Some, like FluxCD, appear out of order (e.g., after ArgoCD)
Image

💡 Expected behavior

  • The list of providers should be consistently sorted — ideally fully alphabetical, or
  • Grouped logically by provider type (e.g. “CI/CD”, “Monitoring”, “Databases”, “Notifications”), with clear section headers.

Either approach is fine as long as it’s consistent and predictable.


✅ Proposed improvement

  • Ensure the provider list on /providers/overview is sorted alphabetically by name,
    or
  • Introduce clear categorization (for example: CI/CD, Infrastructure, Databases, Messaging) and order providers accordingly.

🧠 Rationale

Consistent ordering:

  • Makes documentation easier to navigate visually
  • Helps users quickly locate integrations by name
  • Improves the perceived quality and structure of the docs

Labels: type:enhancement area:documentation priority:low

Metadata

Metadata

Assignees

No one assigned

    Labels

    DocumentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions