Skip to content

inconsistent visibility of AsyncAPI Studio (Beta) in Documentation Tools section #1318

Description

@Jatin24062005

Description
AsyncAPI Studio is a really well-built and promising project for visually designing AsyncAPI documents and event-driven architectures. It is clearly highlighted in the header → Tools dropdown as “Studio (Beta)”, which is great.

However, when navigating to the Docs → Tools section, AsyncAPI Studio is not listed or documented at all, while other tools like Generator, CLI, Modelina, Parsers, etc., are present.

This creates confusion for users because:

  • Studio appears to be an official tool (visible in the main navigation)
  • But it has no dedicated entry or documentation under the Tools section
  • New users may miss Studio entirely when browsing documentation

📍 Where the issue appears

  • Header → Tools dropdown: Shows Studio (Beta)
  • Docs → Tools → Overview: Studio is missing

✅ Expected behavior

  • AsyncAPI Studio should be listed in the Docs → Tools section

  • Ideally include:

    • A short overview of AsyncAPI Studio
    • Its purpose (visual editor for AsyncAPI files)
    • Status clearly marked as Beta
    • Link to Studio usage or getting-started guide

💡 Why this matters

AsyncAPI Studio is one of the most user-friendly ways to work with AsyncAPI, especially for:

  • Beginners
  • Architects
  • Visual learners

Having structured documentation alongside other tools would significantly improve discoverability and adoption.


📸 Screenshots

Image Image
  1. Studio in the header Tools dropdown
  2. Studio missing from Docs → Tools section)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    Status
    Backlog
    Status
    Done

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions