Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fetching Info from async api spec #518

Open
1 of 5 tasks
XaaXaaX opened this issue May 27, 2024 · 0 comments
Open
1 of 5 tasks

Fetching Info from async api spec #518

XaaXaaX opened this issue May 27, 2024 · 0 comments

Comments

@XaaXaaX
Copy link
Contributor

XaaXaaX commented May 27, 2024

Have you read the Contributing Guidelines on issues?

Description

This Feature request is related to asyncapi plugin

Context

The Asyncapi plugin helps to generate automatically the events and services but some missing parts lead to a duplicated work on markdown to well prepare the adoption

Proposal

This can be useful to extract some catalog information from some metadata from async api specs as async API v3 supports tags element as part of the info object. Find Spec Here

The tag object as explained here provides the following informations

asyncapi: 3.0.0
id: '.......'
info:
    title: MyService
    version: 1.0.0
    description: My service description
    tags:
      - name: tagName
         description: Tag Value or description
    externalDocs:
       - description: Find more info here
         url: https://example.com

Details

  • Domain Name
  • Badges
  • Owners
  • External Links

Domain Names

Extracting the DomainName from specification tags under a predefined name exp. DomainName

Owners

Extracting the Owner from specification tags under a predefined name exp. Owner, this is often useful for multi-team catalog

Badges

Generating the Badges, Put the whole tags of AsyncApi as a collection of Badges ( to be clarified if it seems inconvenient)

External Links

Feed the external links from asyncapi externalDocs object

Note: the ideas can be challenged.

Motivation

Remove unnecessary markdown manipulation when using asyncapi spec plugin

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
2 participants