openapi-editor aka enhanced swagger-editor ? · OpenAPITools/openapi-generator#204

(3 comments) (1 reaction) (0 assignees)Java (26,243 stars) (7,516 forks)batch import

General: DiscussionHacktoberfesthelp wanted

Description

Swagger Editor is a good WebUI (see live in action here) to build and edit a swagger/oas API spec.

It's an important starting point for a new user who approach swagger/oas syntax and concepts. For example, it highlight errors and let you generate and download a client/server in one click without using any CLI.

Unfortunately, as similar happened for swagger-codgen, community improvements and in general development was in some manner slowed down. For example https://github.com/swagger-api/swagger-editor/issues/713 and https://github.com/swagger-api/swagger-editor/issues/1480

I think we have enough energy, as we are having success in doing openapi-generator, to fork it and improve without the frictions we could have proposing PRs to original project.

For me, this can be a valid idea if we find at least 5 improvements to do.

What do you think?

Contributor guide

Tech stack: javascripthtmlcss
Domain: frontendtooling
Issue type: feature
Difficulty: 3
Estimated time: over 1 week
Activity status: stale
Clarity: unclear
Prerequisites: JavaScript knowledgeOpenAPI specificationSwagger Editor familiarity
Newbie friendliness: 20
Research direction: Review the referenced Swagger Editor issues (#713, #1480) to identify specific improvements. Investigate the current state of Swagger Editor and check if any forks already exist. Engage maintainers in the openapi generator community to gauge interest and gather requirements.