keep icon indicating copy to clipboard operation
keep copied to clipboard

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

Open gecube opened this issue 4 months ago • 0 comments

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

gecube avatar Oct 24 '25 19:10 gecube