Greptile Summary

This PR expands the Optimize XR Performance section of the Isaac Teleop feature guide with five new dropdowns covering the RTX - Minimal renderer, the XR resolution-multiplier slider, sim.dt/render_interval trade-offs, RetargetingExecutionConfig sync/pipelined modes, and CloudXR frame-pacing diagnostics. Three annotated screenshot assets accompany the renderer and resolution sections.

• RTX - Minimal renderer dropdown explains when to use it, how to enable it from the viewport, recommended Render Settings, and the DistantLight-only limitation with a Python swap snippet.
• XR Resolution Multiplier and Retargeting execution dropdowns provide slider guidance and RetargetingExecutionConfig/DeadlinePacingConfig configuration patterns.
• Physics/render time step section is refreshed for Quest 3 / Pico 4 Ultra (90 Hz) and the old CPU-physics dropdown is removed (already the default).

Confidence Score: 5/5

Documentation-only change with no runtime code modifications; safe to merge.

All changes are prose, reStructuredText markup, and screenshot assets. The code snippets in the new dropdowns match the actual API in isaac_teleop_cfg.py and the script CLI flags. The only finding is a minor documentation consistency gap in the retargeting snippet.

docs/source/features/isaac_teleop.rst — the retargeting execution snippet warrants a quick look for import completeness.

Important Files Changed

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A([XR teleop cannot sustain headset display rate]) --> B{Already tuned\nsim.dt & render_interval?}
    B -- No --> C[Set sim.dt = 1/90\nset render_interval = 2]
    C --> D{Still dropping\nframes?}
    B -- Yes --> D
    D -- No --> Z([Done])
    D -- Yes --> E[Switch viewport to\nRTX - Minimal renderer]
    E --> F[Set Minimal Shading Mode\n= Diffuse/Glossy/Emission]
    F --> G{Using DomeLight?}
    G -- Yes --> H[Swap/supplement with\nDistantLight]
    G -- No --> I{Still dropping\nframes?}
    H --> I
    I -- No --> Z
    I -- Yes --> J[Lower XR Resolution\nMultiplier e.g. 0.8]
    J --> K{Heavy retargeting?}
    K -- Python-light --> L[Use RetargetingExecutionConfig\nmode=sync]
    K -- Native/heavy --> M[Use RetargetingExecutionConfig\nmode=pipelined, tune safety_margin_s]
    L --> N{Frame-time\nspikes visible?}
    M --> N
    N -- Yes --> O[Override CloudXR frame pacer\nvia custom .env + --cloudxr_env]
    N -- No --> Z
    O --> Z

_{Reviews (2): Last reviewed commit: "Remove accidentally committed docs tarba..." | Re-trigger Greptile}

🔄 Isaac Lab Review Bot - Incremental Review Update

Reviewing new commits: 92524e9 → 73d64c5

Summary of New Changes

This incremental update includes:

1. Image format optimization: Converted three documentation screenshots from PNG to JPG format (recommended-render-select, recommended-render-settings, xr-resolution-slider) - reduces file sizes while maintaining visual clarity.

2. Migration guide addition: Added comprehensive docs/teleop_migration_2.3_to_3.0.md (683 lines) - a detailed, machine-actionable guide for migrating custom teleop recording scripts and G1-based environment configs from Isaac Lab 2.3 to 3.0 with Isaac Teleop. This is excellent documentation that covers:

   • CLI argument changes (--enable_pinocchio removal, --teleop_device default change)
   • CloudXR CLI arguments
   • IsaacTeleop stack detection
   • Three-way device path branching
   • Context manager wrapping for simulation loop
   • Quaternion convention changes (WXYZ → XYZW)
   • Pink IK config updates
   • ProxyArray access patterns

3. Changelog enhancement: Updated changelog.d/rwiltz-docs-rtx-minimal-renderer.rst to mention RetargetingExecutionConfig (sync vs pipelined modes), DeadlinePacingConfig.safety_margin_s, and CloudXR frame-pacing diagnostic.

4. Documentation tarball: Added docs/isaaclab-docs.tar.gz for distribution.

Previous Feedback Status

The previous suggestion regarding the DistantLight code example (adding surrounding class skeleton context) remains applicable to the unchanged portion of isaac_teleop.rst.

Overall Assessment

✅ The incremental changes are well-structured and improve the documentation quality. The migration guide is particularly valuable for users upgrading their teleop implementations.

Automated review by Isaac Lab Review Bot

@greptile