Skip to content

[All Platforms][Docs] console copy buttons include leading "$ " prompt that breaks paste #4754

@zNeill

Description

@zNeill

Description

Description

Console code blocks on the NemoClaw docs site render the shell prompt
"$ " as part of the copyable line content. The per-block Copy button
copies the literal "$ nemoclaw ..." text, so pasting it into a terminal
fails (the leading "$ " is not a valid command).
Environment
Device:        docs.nvidia.com/nemoclaw (public documentation site)
OS:            N/A (documentation-site bug; verified via curl)
Architecture:  N/A
Node.js:       N/A
npm:           N/A
Docker:        N/A
OpenShell CLI: 0.0.39 (docs describe this version)
NemoClaw:      v0.0.44 (docs "latest")
OpenClaw:      N/A (docs-only)
Steps to Reproduce
1. Open any page with console examples, e.g.
   https://docs.nvidia.com/nemoclaw/latest/reference/commands.html
2. Hover a console code block and click its Copy button.
3. Paste into a terminal.
Expected Result
The copied text contains only the command, without the shell prompt:
  nemoclaw my-assistant status
Pasting runs the command directly.
Actual Result
The copied text includes the prompt:
  $ nemoclaw my-assistant status
Pasting into a terminal errors (or, worse, the "$ " is silently part of
the command and the user has to delete it every time).

Root cause confirmed in the rendered HTML: the prompt is inside the
copyable line content with no prompt marker, e.g.

  $ nemoclaw my-assistant status

There is no Pygments "gp" (generic-prompt) span and no copybutton
prompt-stripping configured, yet every block has a Copy button
(commands.html has 356 "copy-button" references and 12 "$ nemoclaw"
prompt lines). So the Copy button necessarily includes the "$ ".
Logs
Documentation rendering bug; no runtime logs.
Verified via curl + HTML inspection of the live docs on 2026-05-19.
Suggested Fix
Strip the leading "$ " shell prompt from copyable content. Two options:
  (a) Mark prompts as Pygments "gp" spans so the copy handler excludes
      them, OR
  (b) Configure the docs-site Copy handler to drop a leading prompt
      prefix ("$ ", "# ") from each line before copying.
Also add a docs-CI lint gate that fails the build on stray leading
"$ " inside copy-paste code blocks. (PRR ref: P-30 / PRR-17.)

Bug Details

Field Value
Priority Unprioritized
Action Dev - Open - To fix
Disposition Open issue
Module Machine Learning - NemoClaw
Keyword NemoClaw, NemoClaw_Docs, NEMOCLAW_GH_SYNC_APPROVAL

[NVB#6266521]

Metadata

Metadata

Assignees

Labels

NV QABugs found by the NVIDIA QA Teamarea: docsDocumentation, examples, guides, or docs build

Type

No fields configured for Bug.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions