Utility for comparing two OpenAPI specifications.

OpenAPITools/openapi-diff có thân thiện với người mới không?

Gần đây có quá ít pull request của người đóng góp bên ngoài gửi tới OpenAPITools/openapi-diff để nói chúng được merge thường xuyên đến đâu. Hiện có 2 issue phù hợp với người mới đang mở.

Star
1.1k
Fork
191
Issue cho người mới đang mở
2
Issue đã lập chỉ mục
69
Ngôn ngữ chính
Java
Giấy phép
Apache-2.0
Lần push lên GitHub gần nhất
5/8/2026
Lập chỉ mục gần nhất
19/9/2026
Hướng dẫn đóng góp
Hướng dẫn đóng góp
Quy tắc ứng xử
Quy tắc ứng xử
Label cho người mới
help wanted good first issue
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Cách đóng góp cho OpenAPITools/openapi-diff

  1. Hãy đọc hướng dẫn đóng góp trước: nó cho biết maintainer muốn thay đổi được đề xuất, kiểm thử và review ra sao.
  2. Dự án có Dockerfile hoặc tệp Docker Compose, nên bạn có thể chạy nó mà không cần cài cả bộ công cụ.
  3. Hãy đọc quy tắc ứng xử: nó áp dụng cho issue và pull request cũng như trò chuyện.
  4. Chọn một trong 2 issue phù hợp với người mới đang mở bên dưới và bình luận rằng bạn muốn làm nó trước khi bắt đầu.

Các issue có thể đã có người làm được xếp cuối danh sách. Sắp xếp tất cả theo ngày

  • Feature Request: generate Overlay for the given 2 OpenAPI files
    Đang mở

    Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100

    OpenAPITools/openapi-diff#883 ·

  • Operations are detected as changed when comparing for open api version 3.0.1 and 3.1.0
    Đang mở
    OpenAP 3.1.0 Support

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 45/100

    OpenAPITools/openapi-diff#858 ·

  • TeamCity renderer
    Đang mở
    Render capabilities

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100

    OpenAPITools/openapi-diff#849 ·

  • ExtensionDiff in renderers (just tried console and html)
    Đang mở
    enhancement Render capabilities

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 35/100

    OpenAPITools/openapi-diff#839 · 1 bình luận ·

  • Bug: erroneous detection of changes with mediaTypes, failure to generate html/markdown reports
    Đang mở

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 45/100

    OpenAPITools/openapi-diff#805 · 1 bình luận ·

  • Bug: no details when securitySchemes.*.name changes
    Đang mở
    OpenAP 3.1.0 Support

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 45/100

    OpenAPITools/openapi-diff#802 ·

  • Support for detecting changes in webhooks
    Đang mở
    OpenAP 3.1.0 Support

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 42/100

    OpenAPITools/openapi-diff#793 ·

  • Exception in thread "main" java.lang.StackOverflowError
    Đang mở
    bug

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100

    OpenAPITools/openapi-diff#788 ·

  • Unify Handling of allOf/anyOf and oneOf in Diff logic
    Đang mở
    enhancement

    Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 35/100

    OpenAPITools/openapi-diff#772 ·

  • Markdown output does not specify whether the change is backward-compatible or not
    Đang mở
    Breaking/Non-Breaking classification Render capabilities

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 48/100

    OpenAPITools/openapi-diff#766 · 1 bình luận · 1 reaction ·

  • Comparing OpenAPI 3.0.1 to 3.1.0 does not work
    Đang mở
    OpenAP 3.1.0 Support

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100

    OpenAPITools/openapi-diff#755 · 5 bình luận · 1 reaction ·

  • [OpenAPI 3.1.0 support] JsonSchema type changes not handled.
    Đang mở
    OpenAP 3.1.0 Support

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100

    OpenAPITools/openapi-diff#745 ·

  • Schema description update should be considered as a metadata change
    Đang mở
    Breaking/Non-Breaking classification duplicate

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 45/100

    OpenAPITools/openapi-diff#694 · 2 bình luận ·

  • Deleted or renamed properties are marked as backwards compatible
    Đang mở
    Breaking/Non-Breaking classification

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 52/100

    OpenAPITools/openapi-diff#673 · 7 bình luận · 3 reaction ·

  • Report totals
    Đang mở
    enhancement

    Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100

    OpenAPITools/openapi-diff#627 · 1 reaction ·

  • Output in text and markdown not equivalent (text output incomplete)
    Đang mở
    enhancement Render capabilities

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 30/100

    OpenAPITools/openapi-diff#620 · 2 bình luận · 1 reaction ·

  • No backward compatible changes in Schema are marked as Compatible
    Đang mở
    Breaking/Non-Breaking classification

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100

    OpenAPITools/openapi-diff#611 · 4 reaction ·

  • The current openapi-diff implementation does not capture differences in extensions that occur at the properties level (attributes under the type object) and the path level
    Đang mở

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 30/100

    OpenAPITools/openapi-diff#604 ·

  • Removing a mandatory or optional property in the input data : breaking change ?
    Đang mở
    Breaking/Non-Breaking classification question

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 25/100

    OpenAPITools/openapi-diff#599 · 2 bình luận ·

  • [bug] [polymorphism] Changes in child schema are ignored when only parent schema is directly referenced
    Đang mở

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 38/100

    OpenAPITools/openapi-diff#571 · 1 bình luận ·

  • --json output is absurdly huge
    Đang mở
    enhancement Render capabilities

    Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100

    OpenAPITools/openapi-diff#562 · 1 bình luận · 8 reaction ·

  • incompatible api diff result when one of property in model becomes not required
    Đang mở
    Breaking/Non-Breaking classification

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 38/100

    OpenAPITools/openapi-diff#535 · 2 bình luận · 1 reaction ·

  • [2.1.0-beta.6 and oas-3.1.0] Request body property data type change is detected as compatible or no_change
    Đang mở
    Breaking/Non-Breaking classification

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 38/100

    OpenAPITools/openapi-diff#528 · 1 bình luận · 3 reaction ·

  • enum and properties change in schemas not reported in .md file generated after diff check
    Đang mở

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 42/100

    OpenAPITools/openapi-diff#523 ·

  • In openapi-diff-cli add old and new filenames to the output
    Đang mở
    enhancement

    Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100

    OpenAPITools/openapi-diff#506 ·

  • False positive when adding optional property
    Đang mở
    Breaking/Non-Breaking classification

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 42/100

    OpenAPITools/openapi-diff#490 · 3 bình luận · 1 reaction ·

  • Do not fail with breaking changes when major version is bumped
    Đang mở
    Breaking/Non-Breaking classification enhancement

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100

    OpenAPITools/openapi-diff#460 · 2 bình luận ·

  • allOf : `type` of property contained in multiple subschemas is not correctly determined.
    Đang mở

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 35/100

    OpenAPITools/openapi-diff#392 · 4 bình luận · 2 reaction ·

  • Consider removal of deprecated elements as compatible
    Đang mở
    Breaking/Non-Breaking classification

    Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 20/100

    OpenAPITools/openapi-diff#371 · 4 bình luận ·

  • HtmlRender: Notes of Parameters shows always the new description
    Đang mở
    good first issue help wanted

    Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100

    OpenAPITools/openapi-diff#364 ·

  • Problem creating changelog in HTML
    Đang mở

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 35/100

    OpenAPITools/openapi-diff#362 ·

  • Template-based output
    Đang mở
    enhancement help wanted

    Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100

    OpenAPITools/openapi-diff#355 · 1 reaction ·

  • Removing a security scheme is considered incompatible
    Đang mở
    Breaking/Non-Breaking classification question

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100

    OpenAPITools/openapi-diff#330 · 1 bình luận ·

  • False positive breaking change when making a required request body optional
    Đang mở
    Breaking/Non-Breaking classification

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 38/100

    OpenAPITools/openapi-diff#329 · 6 reaction ·

  • Markdown output does not contain compatibility information
    Đang mở

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 45/100

    OpenAPITools/openapi-diff#325 · 2 bình luận · 12 reaction ·

  • Evaluate creating native images
    Đang mở
    enhancement

    Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100

    OpenAPITools/openapi-diff#310 ·

  • Evaluate using JReleaser
    Đang mở
    enhancement

    Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100

    OpenAPITools/openapi-diff#309 ·

  • Wrong changelog generated when having objects with same field name
    Đang mở

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100

    OpenAPITools/openapi-diff#268 · 4 bình luận · 2 reaction ·

  • Adding a new optional property to the request/response body is considered backward incompatible.
    Đang mở
    Breaking/Non-Breaking classification

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 25/100

    OpenAPITools/openapi-diff#264 · 5 bình luận ·

  • Version identifiers in paths
    Đang mở
    enhancement help wanted

    Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 25/100

    OpenAPITools/openapi-diff#253 · 3 bình luận · 1 reaction ·

  • PUT new attribute backwards compatibility optional
    Đang mở
    Breaking/Non-Breaking classification question

    Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 30/100

    OpenAPITools/openapi-diff#251 · 4 reaction ·

  • false positive for type if only the format is changed.
    Đang mở

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 42/100

    OpenAPITools/openapi-diff#248 · 2 bình luận · 3 reaction ·

  • Doesn't detect/render additions to the API
    Đang mở

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 30/100

    OpenAPITools/openapi-diff#230 · 1 bình luận ·

  • HtmlRender reports far less informations than MarkdownRender
    Đang mở

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 30/100

    OpenAPITools/openapi-diff#215 · 2 bình luận ·

  • Show additions / changes to schema body
    Đang mở
    enhancement

    Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 48/100

    OpenAPITools/openapi-diff#207 · 4 bình luận · 4 reaction ·

  • Add official Github action for openapi-diff
    Đang mở
    enhancement

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 35/100

    OpenAPITools/openapi-diff#186 · 4 bình luận · 20 reaction ·

  • Reference resolved against wrong components.
    Đang mở
    Still Valid?

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 25/100

    OpenAPITools/openapi-diff#139 · 1 bình luận ·

  • Add documentation for detectable breaking/non-breaking changes
    Đang mở
    Breaking/Non-Breaking classification enhancement

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 45/100

    OpenAPITools/openapi-diff#138 · 1 bình luận · 6 reaction ·

  • Adding option to ignore user specified changes
    Đang mở
    enhancement

    Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 20/100

    OpenAPITools/openapi-diff#129 · 2 bình luận ·

  • Stackoverflow error with cyclic references involving allOf
    Đang mở

    Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 42/100

    OpenAPITools/openapi-diff#124 · 1 bình luận · 6 reaction ·

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.