sphinx-contrib/openapi

OpenAPI (fka Swagger) spec renderer for Sphinx.

Stars: 126
Forks: 88
Open beginner issues: 0
Indexed issues: 46

Dominant language: Python
License: BSD-2-Clause
Last GitHub push: Aug 17, 2026
Latest indexed: Sep 19, 2026
Contributing guide: No contributing guide
Code of conduct: No code of conduct
Beginner labels: help wanted
PR merge metrics: No merged PRs in 30d

Beginner friendly Everything

Open All

5 beginner-friendly issues open

Old renderer with :request: crashes with KeyError: 'properties' for a non-object request body on OAS 3.0 Open

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

sphinx-contrib/openapi#178 · Opened Aug 13, 2026
httpdomain renderer: block-scalar summary produces unpaired ** and literal asterisks in output Open

Difficulty 1/5 Under an hour Newbie friendliness 85/100

sphinx-contrib/openapi#173 · Opened Aug 13, 2026
Old renderer with :request: emits a sourcecode block without a trailing blank line, warning under -W Open

Difficulty 1/5 Under an hour Newbie friendliness 90/100

sphinx-contrib/openapi#171 · Opened Aug 13, 2026
ValueError: dictionary update sequence element #0 has length 1; 2 is required Open

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

sphinx-contrib/openapi#166 · 1 comment · Opened May 29, 2025
Exception raised on enum query parameters without "type" Open

Difficulty 2/5 1-3 hours Newbie friendliness 62/100

sphinx-contrib/openapi#106 · 1 reaction · Opened Jan 12, 2021

A short digest of beginner-friendly GitHub issues.