Issues

• JSON Schema for OpenAPI YAML document (in VS Code)

  OAI/learn.openapis.org#216 · Filter by author Rabadash8820 opened on Oct 7, 2026
  2

• feedback on best practices section

  OAI/learn.openapis.org#203 · Filter by author baywet opened on Apr 13, 2026

• Patterns and practices - Overlay for globals

  OAI/learn.openapis.org#200 · Filter by author baywet opened on Apr 9, 2026
  

• Add LLM.txt to the learn site

  OAI/learn.openapis.org#199 · Filter by author miqui opened on Apr 7, 2026

• Consider adding a linkchecker if that's useful?

  OAI/learn.openapis.org#191 · Filter by author baywet opened on Mar 5, 2026

• Security scheme ApiKey parameter clarification

  OAI/learn.openapis.org#187 · Filter by author Fresa opened on Feb 3, 2026
  5

• Add ReadOnly and WriteOnly information to the 3.0 to 3.1 upgrade guide

  OAI/learn.openapis.org#139 · Filter by author lornajane opened on Sep 17, 2025
  

• Document RFC9727 usage for discovering OADs

  OAI/learn.openapis.org#136 · Filter by author handrews opened on Aug 20, 2025
  1

• issue: Missing scopes map in app2AppOauth OAuth flow example

  OAI/learn.openapis.org#134 · Filter by author konradodwrot opened on Jul 9, 2025

• Suggestion: Update RFC Reference for HTTP Authentication

  OAI/learn.openapis.org#133 · Filter by author konradodwrot opened on Jul 9, 2025
  2

• Guidance on response modeling, including no content

  OAI/learn.openapis.org#132 · Filter by author handrews opened on May 28, 2025

• Tags documentation

  OAI/learn.openapis.org#131 · Filter by author lornajane opened on May 28, 2025

• Example of custom format values?

  OAI/learn.openapis.org#128 · Filter by author thockin opened on Apr 16, 2025
  4

• Add descriptions and examples of common API authentication scenarios

  OAI/learn.openapis.org#126 · Filter by author mikekistler opened on Feb 27, 2025
  11

• examples in json are difficult to read

  OAI/learn.openapis.org#123 · Filter by author karenetheridge opened on Dec 24, 2024
  1

• examples are for v3.0 only

  OAI/learn.openapis.org#122 · Filter by author karenetheridge opened on Dec 24, 2024
  1

• Add/update examples for new templating abnf

  OAI/learn.openapis.org#120 · Filter by author baywet opened on Dec 19, 2024
  1

• Add a quickstart

  OAI/learn.openapis.org#111 · Filter by author lornajane opened on Nov 4, 2024

• Add descriptions for the example pages

  good first issue
  OAI/learn.openapis.org#106 · Filter by author lornajane opened on Aug 15, 2024

• Improve TicTacToe example?

  OAI/learn.openapis.org#103 · Filter by author zx80 opened on Jun 28, 2024

• oneOf or anyOf for the header schema

  OAI/learn.openapis.org#94 · Filter by author triptesh1212 opened on Apr 29, 2024
  1

• Add a page cataloging a curated list of example OpenAPI documents

  OAI/learn.openapis.org#89 · Filter by author SensibleWood opened on Mar 17, 2024
  2

• Links in SVG images do not match intended targets in the OAS page

  OAI/learn.openapis.org#86 · Filter by author karelhusa opened on Feb 17, 2024

• fix: Resize the column from just-the-docs theme

  OAI/learn.openapis.org#85 · Filter by author SensibleWood opened on Feb 16, 2024
  3

• ReadOnly / WriteOnly clarification toward required field

  OAI/learn.openapis.org#101 · Filter by author LasneF opened on Jan 31, 2024
  8