Skip to content

refactor: correct the documented term-recording output path - #445

Merged
has2k1 merged 1 commit into
mainfrom
refactor/term-player-docstring
Oct 27, 2026
Merged

has2k1 merged 1 commit into
mainfrom
refactor/term-player-docstring

Conversation

@has2k1

@has2k1 has2k1 commented Oct 27, 2026

Copy link
Copy Markdown
Collaborator

This PR corrects the docstring of the build step that pre-renders .termshow recordings, and removes an import guard around the term player. The docstring said recordings render into great-docs/termshow/, but they go into termshow/ under the build directory, which is not always named great-docs. The guard caught an ImportError that cannot happen: the term player imports only the standard library and a hard dependency.

…guard

The term-recording pre-render docstring said recordings render into
`great-docs/termshow/`. They render into `termshow/` under the build
directory, which is not always named `great-docs`. Correct the docstring
and document its logger parameter.

The term player imports only the standard library and a hard dependency of
the package, so the `ImportError` guard around its import could not fire.
Remove it. Behaviour is unchanged.
@github-actions

Copy link
Copy Markdown

📚 Preview this PR's docs locally

Fetch the just-built site and open it in your browser:

# this exact build
great-docs preview --run 40541908237

# or always the latest build for this PR
great-docs preview --pr 445
Auth & tips
  • Requires great-docs: pip install great-docs (or run via pipx/uvx).
  • Auth: run gh auth login then add --use-gh, or set GITHUB_TOKEN (needs Actions: read).
  • Jump to a page: add --path reference/index.html.
  • Latest vs exact: --pr <n> grabs the newest build; --run <id> pins this one.
  • Re-download: --refresh ignores the local cache.

@has2k1
has2k1 merged commit c4f4c9e into main Oct 27, 2026
8 checks passed
@has2k1
has2k1 deleted the refactor/term-player-docstring branch October 27, 2026 16:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant