Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

OAI/learn.openapis.org

Đăng nhập để theo dõi Xem trên GitHub

OpenAPI - Getting started, and the specification explained

OAI/learn.openapis.org có thân thiện với người mới không?

Maintainer của OAI/learn.openapis.org thường phản hồi pull request trong vòng 1 ngày. Hiện chưa có issue nào phù hợp với người mới đang mở; danh sách bên dưới là các issue khác chúng tôi có của kho này.

Star
236
Fork
123
Issue cho người mới đang mở
0
Issue đã lập chỉ mục
38
Merge trung bình
9 giờ 29 phút
Pull request đã merge (30 ngày)
8
Ngôn ngữ chính
Markdown
Giấy phép
CC-BY-4.0
Lần push lên GitHub gần nhất
10/10/2026
Lập chỉ mục gần nhất
20/9/2026
Hướng dẫn đóng góp
Quy tắc ứng xử
Label cho người mới
good first issue

Cách đóng góp cho OAI/learn.openapis.org

  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. Hãy đọc quy tắc ứng xử: nó áp dụng cho issue và pull request cũng như trò chuyện.
  3. Đóng góp của bạn sẽ được phát hành theo giấy phép CC-BY-4.0 của dự án.
  4. Theo dõi kho này để biết khi có issue mới phù hợp với người mới, hoặc xem các issue khác bên dưới.
Phù hợp cho người mới Tất cả
Đang mở Tất cả

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

  • JSON Schema for OpenAPI YAML document (in VS Code)
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#216 · 2 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • feedback on best practices section
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#203 ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Add LLM.txt to the learn site
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#199 ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Consider adding a linkchecker if that's useful?
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#191 ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Security scheme ApiKey parameter clarification
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#187 · 5 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Add ReadOnly and WriteOnly information to the 3.0 to 3.1 upgrade guide
    Có thể làm lại được Đang mở
    • Có gì không ổn?

    OAI/learn.openapis.org#139 · 1 người được giao ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Document RFC9727 usage for discovering OADs
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#136 · 1 bình luận · 2 reaction ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • issue: Missing scopes map in app2AppOauth OAuth flow example
    Đang mở
    • Có gì không ổn?

    Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 55/100

    OAI/learn.openapis.org#134 ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Suggestion: Update RFC Reference for HTTP Authentication
    Đang mở
    • Có gì không ổn?

    Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 55/100

    OAI/learn.openapis.org#133 · 2 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Guidance on response modeling, including no content
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#132 · 2 reaction ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Tags documentation
    Đang mở
    • Có gì không ổn?

    Độ khó 2/5 Nửa ngày Mức phù hợp với người mới 55/100

    OAI/learn.openapis.org#131 ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Example of custom `format` values?
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#128 · 4 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Add descriptions and examples of common API authentication scenarios
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#126 · 11 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • examples in json are difficult to read
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#123 · 1 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • examples are for v3.0 only
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#122 · 1 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Add/update examples for new templating abnf
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#120 · 1 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Add a quickstart
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#111 ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Add descriptions for the example pages
    Đang mở
    • Có gì không ổn?
    good first issue

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

    OAI/learn.openapis.org#106 ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Improve TicTacToe example?
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#103 ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • oneOf or anyOf for the header schema
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#94 · 1 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Add a page cataloging a curated list of example OpenAPI documents
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#89 · 2 bình luận · 1 reaction ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Links in SVG images do not match intended targets in the OAS page
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#86 ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • fix: Resize the column from just-the-docs theme
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#85 · 3 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • ReadOnly / WriteOnly clarification toward required field
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#101 · 8 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Callbacks and Webhooks, with examples
    Có thể làm lại được Đang mở
    • Có gì không ổn?

    OAI/learn.openapis.org#76 · 2 bình luận · 1 người được giao ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Explanation of sibling refs
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#75 · 1 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • I'm trying to document an existing API that uses a single path with query parameters to specify the different actions:
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#62 · 1 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Outstanding items to include
    Đang mở
    • Có gì không ổn?
    documentation

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

    OAI/learn.openapis.org#59 · 6 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Add to best-practices guides on formats and alternative JSON Schema approaches
    Có thể làm lại được Đang mở
    • Có gì không ổn?
    documentation

    OAI/learn.openapis.org#42 · 1 người được giao ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Group schema components by content-type
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#141 · 12 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • OpenAPI 3.1.0 petstore fixture
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#98 · 8 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Need better examples
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#96 · 2 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Index of examples to create
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#88 · 3 bình luận · 1 reaction ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Improve examples
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#99 · 8 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • More and complete examples for serialization styles
    Đang mở
    • Có gì không ổn?

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

    OAI/learn.openapis.org#100 · 19 bình luận · 2 reaction ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Should we have more schema examples?
    Đang mở
    • Có gì không ổn?
    documentation

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

    OAI/learn.openapis.org#81 · 9 bình luận ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Documentation improvements: Tutorials and FAQs
    Đang mở
    • Có gì không ổn?
    documentation

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

    OAI/learn.openapis.org#82 · 1 bình luận · 5 reaction ·

    Maintainer thường phản hồi trong vòng 1 ngày

  • Patterns and practices - Overlay for globals
    Có thể đã có người làm Đang mở
    • Có gì không ổn?

    OAI/learn.openapis.org#200 · 1 người được giao ·

    Maintainer thường phản hồi trong vòng 1 ngày

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.