This repository is the official source of truth for the OpenAPI Specification (OAS), the industry-standard format for describing HTTP APIs. It is not a runtime application but rather a meticulously managed collection of specification documents, JSON Schema files, proposals, and the infrastructure tooling required to build, validate, and publish the specification. The repository's architecture is a monorepo for a standard, leveraging a shared build infrastructure package (`@oai/build-infra`) for tasks like markdown linting, HTML generation, and schema publication. Key entry points include the versioned specification files in `versions/`, the CI/CD workflows in `.github/workflows/`, and the governance documents. The primary data flow involves transforming Markdown specification sources into published HTML and JSON Schema artifacts. The repository demonstrates high craftsmanship in its governance model, branch management strategy (main/dev/release branches with automated syncing), and issue automation. It is actively maintained with a low technical drift risk, making it a model for how open standards should be managed. While the core content is a specification, the repository itself functions as an application of infrastructure tooling, with sophisticated CI/CD pipelines, test suites for schema validation and markdown rendering, and reusable scripts for branch management and issue lifecycle automation.
This repository is a comprehensive educational course titled '.NET Web API Zero to Hero' by codewithmukesh. It contains over 50 independent ASP.NET Core Web API sample projects organized into modules covering fundamentals (minimal APIs, exception handling, logging), database management with EF Core (CRUD, migrations, interceptors, soft deletes, bulk operations, pagination), advanced API patterns (CQRS with MediatR, custom dispatcher, Result pattern, mapping benchmarks), performance and caching (in-memory, Redis, HybridCache, EF second-level cache), API security (JWT, refresh tokens, role/claims/policy/permission-based authorization, API keys, CORS, rate limiting), file handling (PDF invoice generation), architecture (Clean Architecture vs Vertical Slice), observability (health checks, structured logging), and background processing. Each sample is a self-contained, runnable project with minimal setup (often using in-memory databases) and includes extensive BenchmarkDotNet performance comparisons. The code is well-structured, follows modern .NET 10 patterns, and demonstrates production-quality implementations of cross-cutting concerns like global exception handling, validation pipelines, and caching strategies. While the repo is primarily a teaching resource, many components (custom CQRS dispatcher, Result pattern, EF Core interceptors, permission-based authorization) are genuinely reusable in other projects.