posit-dev/great-docs

View on GitHub

Documentation sites for Python packages: start simple, go deep

Stars: 262
Forks: 18
Open beginner issues: 0
Indexed issues: 22
Avg merge: 1d 4h
Merged PRs (30d): 14

Dominant language: Python
License: MIT
Last GitHub push: Sep 16, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

22 open issues indexed

Tools for building and debugging notebooks Open

Type: ★ Enhancement

Difficulty 4/5 3-5 days Newbie friendliness 52/100

posit-dev/great-docs#353 · Opened Sep 14, 2026
Every page advertises llms.txt and llms-full.txt, but they are only generated for projects with an API reference — docs-only sites ship two dead links Open

Effort: [1] Low Priority: [3] High Type: ☹︎ Bug

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

posit-dev/great-docs#350 · Opened Sep 11, 2026
`_fix_numeric_prefix_links` only rewrites `.qmd` links, but section discovery strips numeric prefixes from `.md` files too Open

Difficulty: [2] Intermediate Effort: [2] Medium Priority: [3] High Type: ☹︎ Bug

posit-dev/great-docs#349 · 1 comment · 1 assignee · Opened Sep 11, 2026
Citation anchors collide and references resolve to the wrong target Open

Difficulty: [3] Advanced Priority: [2] Medium Type: ☹︎ Bug

posit-dev/great-docs#334 · 1 assignee · Opened Aug 31, 2026
No working live-preview loop: `build --watch` watches the generated copies, `preview` watches nothing Open

Difficulty: [3] Advanced Effort: [3] High Priority: [2] Medium Type: ★ Enhancement

posit-dev/great-docs#331 · 1 assignee · Opened Aug 27, 2026
feat: unified Python + R documentation sites (multi-language adapter) Open

Difficulty 5/5 Over a week Newbie friendliness 25/100

posit-dev/great-docs#330 · 1 comment · 1 reaction · Opened Aug 27, 2026
Allow `great-docs.yml` and build dir to live inside `docs` Open

Difficulty: [3] Advanced Effort: [3] High Priority: [3] High Type: ★ Enhancement

posit-dev/great-docs#329 · 4 comments · 1 reaction · 1 assignee · Opened Aug 25, 2026
Customization options to replicate Quarto appearance Open

Difficulty: [3] Advanced Effort: [3] High Priority: [3] High Type: ★ Enhancement

posit-dev/great-docs#328 · 1 comment · 1 assignee · Opened Aug 25, 2026
MCP/CLI-only projects are missing links to their API indexes Open

Difficulty: [2] Intermediate Effort: [2] Medium Priority: [3] High Type: ☹︎ Bug

posit-dev/great-docs#323 · 1 assignee · Opened Aug 19, 2026
feature: support documentation of `WHEELS.md` for Python project docs Open

Difficulty: [1] Novice Effort: [2] Medium Priority: [2] Medium Type: ★ Enhancement

posit-dev/great-docs#312 · 1 assignee · Opened Aug 7, 2026
Enable release detection for private repositories Open

Difficulty: [2] Intermediate Effort: [2] Medium Priority: [2] Medium Type: ★ Enhancement

Difficulty 5/5 Over a week Newbie friendliness 35/100

posit-dev/great-docs#291 · Opened Jul 28, 2026
Use Pydantic `BaseModel` description for documentation Open

Difficulty: [3] Advanced Effort: [2] Medium Priority: [3] High Type: ★ Enhancement

posit-dev/great-docs#281 · 1 assignee · Opened Jul 24, 2026
Quarto render time scales ~quadratically with API page count due to the generated per-object sidebar (19.5 min → 31 s for a 90-page site) Open

Difficulty: [2] Intermediate Effort: [2] Medium Priority: [3] High Type: ★ Enhancement

posit-dev/great-docs#261 · 1 assignee · Opened Jul 15, 2026
feat: display base classes Open

Difficulty: [2] Intermediate Effort: [2] Medium Priority: [3] High Type: ★ Enhancement

posit-dev/great-docs#202 · 1 comment · 2 assignees · Opened Jun 8, 2026
docments (and perhaps other) parsers Open

Difficulty: [2] Intermediate Effort: [3] High Priority: [2] Medium Type: ★ Enhancement

posit-dev/great-docs#149 · 1 comment · 1 reaction · 1 assignee · Opened May 1, 2026
Plots with automatic paired light/dark-mode outputs Open

Difficulty: [2] Intermediate Effort: [2] Medium Priority: [2] Medium Type: ★ Enhancement

posit-dev/great-docs#135 · 1 comment · 1 assignee · Opened Apr 23, 2026
Preview changes in object signature in dev Open

Difficulty: [3] Advanced Effort: [3] High Priority: [3] High Type: ★ Enhancement

posit-dev/great-docs#120 · 1 assignee · Opened Apr 19, 2026
Get rid of post-render.py Open

Difficulty: [2] Intermediate Effort: [3] High Priority: [2] Medium Type: ٩(͡๏̯͡๏)۶ Refactor

posit-dev/great-docs#30 · 1 comment · 1 assignee · Opened Mar 12, 2026
Add interlinks filter Open

posit-dev/great-docs#29 · 1 assignee · Opened Mar 12, 2026
feat: move type annotations for parameters onto the next line Open

Difficulty: [2] Intermediate Effort: [2] Medium Priority: [1] Low Type: ★ Enhancement

posit-dev/great-docs#18 · 1 assignee · Opened Dec 5, 2025
feat: type annotations in signature presentation Open

Difficulty: [2] Intermediate Effort: [2] Medium Priority: [1] Low Type: ★ Enhancement

posit-dev/great-docs#12 · 1 assignee · Opened Dec 5, 2025
brand.yml Open

Difficulty: [2] Intermediate Effort: [2] Medium Priority: [2] Medium Type: ★ Enhancement

Difficulty 5/5 Over a week Newbie friendliness 20/100

posit-dev/great-docs#2 · 1 comment · Opened Dec 2, 2025

posit-dev/great-docs

Get new issues in your inbox