Apicurio-studio: yml API의 경로 순서가 정렬되지 않고 UI의 경로와 일치하지 않습니다.

죄송합니다. ReDoc 스크린샷에 사용한 YML을 첨부하는 것을 잊었습니다.
(내가 붙여 넣은 것은 작업이 없으므로 ReDoc은 빈 문서를 생성합니다)

openapi: 3.0.2
info:
    title: 'Test API'
    version: 1.0.0
paths:
    '/foo/{id_foo}':
        get:
            summary: 'Obtain a foo'
            parameters:
                -
                    name: id_foo
                    in: path
                    required: true
                    schema:
                        type: number
            responses:
                '201':
                    description: 'A foo'
    /bar:
        post:
            summary: 'Create a bar'
            responses:
                '200':
                    description: 'A bar'
    '/bar/{id_bar}':
        get:
            summary: 'Obtain a bar'
            parameters:
                -
                    name: id_bar
                    in: path
                    required: true
                    schema:
                        type: number
            responses:
                '201':
                    description: 'Bar created'
    /foo:
        post:
            summary: 'Create a foo'
            responses:
                '200':
                    description: 'Foo created'

이것은 놀랍게도 이전에 나타나지 않은 흥미로운 문제입니다! 실제로 UI에는 옵션 C를 제공해야 한다고 생각하는 몇 군데가 있습니다. 문서에 나타나는 순서대로 항목을 표시하지만 정렬 및 재정렬(아마도 끌어서 놓기) 옵션을 제공합니다.

즉, 임시 솔루션은 콘텐츠를 ReDoc에 전달 하기 전에 경로와 기타 목록을 정렬하는 것입니다. 그것은 빠르고 쉽게 할 수 있으며 Apicurio "미리보기" 기능의 특정 문제를 해결할 것입니다.

이에 대한 생각/아이디어가 있습니까? @jsenko ?

나도 이 문제에 부딪쳤다. 이에 대한 내 관찰은 APICURIO가 ​​새 경로를 만들 때 현재 YAML에 새 정의를 추가한다는 것입니다. 또는 yaml을 완전히 대체할 때(예: '소스' 탭에서 수정하는 경우 개별 경로).

나는 YAML을 직접 수정한 후(그런 다음 열 업데이트) 이 문제를 해결하기 위해 데이터베이스를 수동으로 조작하고 어떻게든 프로젝트를 제거하고 다시 시작해야 하는 모든 것이 깨졌습니다.

@EricWittmann 이 말했듯이 콘텐츠를 ReDoc에 넘기기 전에 경로와 기타 목록을 정렬하는 것이 가장 좋다고 생각합니다. 우리 스스로 처리할 수 있습니다.

#394와 마찬가지로 여기의 일반적인 아이디어는 Apicurio UI가 모든 유형의 요소(경로, 필드, 아마도 데이터 유형)에 대한 YAML 순서와 일치해야 한다는 것입니다. 그 순서는 때때로 중요하기 때문입니다(예: 문서 생성).

여기에서 도움이 될 간단한 한 가지는 원시 YAML을 편집하고 요소의 순서만 변경할 때 저장 버튼을 활성화하는 것입니다. 현재 Apicurio는 너무 똑똑하고 변경된 유일한 요소가 요소의 순서일 때 저장 버튼을 회색으로 표시합니다.

나는 가장 좋은 것은 (언급된 바와 같이) 소스와 일치하도록 UI에서 순서를 지정하고 사용자가 끌어서 놓기를 통해 물건을 이동할 수 있도록 하는 것이라고 생각합니다. 그것은 사소한 변화가 아니지만 IMO를 하는 것이 옳은 일입니다. 생각 @jsenko ?