Skip to content

Reorganize interactive simulation documentation - #508

Merged
yuecideng merged 1 commit into
mainfrom
docs/interaction-documentation
Aug 12, 2026
Merged

Reorganize interactive simulation documentation#508
yuecideng merged 1 commit into
mainfrom
docs/interaction-documentation

Conversation

@yuecideng

Copy link
Copy Markdown
Contributor

Description

Reorganizes the interactive simulation documentation around frontends,
cross-frontend controls, and task-specific workflows.

  • Presents the Viser browser as a canonical interaction frontend alongside the
    native DexSim window.
  • Adds a feature-level guide for interactive Gizmos and links interactive
    trajectory replay from the landing page.
  • Moves asset preview into the task-oriented guides section while preserving
    the old URL as a migration stub.
  • Links workspace visualization and grasp annotation as related workflows
    without duplicating their dedicated documentation.

No issue is linked. No dependencies are required or changed.

Type of change

  • Documentation update

Screenshots

Not applicable; this PR changes documentation structure, navigation, and prose.

Validation

  • black --check --diff --color ./ (656 files unchanged)
  • python -m sphinx -q -b html -w <warnings.log> docs/source <html>
    (exit 0; no warnings attributable to the new or reorganized pages)
  • python -m embodichain preview-asset --help
  • python -m pytest tests/visualization/test_example_tutorial_coverage.py -q
    (1 passed)
  • git diff --check

The full Python test suite was not run because this is a documentation-only
change. The Sphinx build retains unrelated repository baseline warnings; the
warning on simready_pipeline.md:26 also exists on main.

Checklist

  • I have run Black validation; no formatting changes were needed.
  • I have made the corresponding documentation changes.
  • I have added tests (not applicable to this documentation-only change).
  • Dependencies are unchanged.

Document Viser as a canonical interaction frontend and add a Gizmo feature guide.
Move asset preview into the task-oriented guides section while retaining the old URL as a migration stub.
@yuecidengyuecideng added docs Improvements or additions to documentation visualization Features or functions for visualization with the simulation interaction The interaction simulation features labels Aug 12, 2026
@greptile-apps

Copy link
Copy Markdown

Greptile Summary

Reorganizes interactive-simulation documentation around native and Viser frontends, shared Gizmo controls, and task-oriented workflows.

  • Adds a cross-frontend Gizmo feature guide and connects it to the existing tutorial and Viser reference.
  • Moves asset-preview documentation into the guides section while retaining an old-path migration page.
  • Adds navigation to interactive trajectory replay, workspace visualization, and grasp annotation.
  • Consolidates preview-asset CLI behavior, options, multi-asset placement, and examples.

Confidence Score: 5/5

The documentation-only reorganization appears safe to merge, with no concrete broken links, incorrect workflows, or repository-rule violations identified.

The new navigation targets and labels resolve, the moved page retains an old-path migration stub, the literal-include marker exists, and the documented CLI and Gizmo workflows align with their implementations.

Important Files Changed

FilenameOverview
docs/source/features/interaction/index.rstReframes interactive simulation around frontends, controls, and related workflows with resolving navigation targets.
docs/source/features/interaction/gizmo.mdAdds an accurate feature-level guide for Gizmo targets, lifecycle, update loops, and Viser trust boundaries.
docs/source/guides/preview_asset.mdAdds a comprehensive task-oriented asset-preview guide consistent with the current CLI and object pose APIs.
docs/source/features/interaction/preview_asset.mdReplaces the former guide with an orphan migration page preserving the old documentation path.
docs/source/overview/sim/viser_visualization.mdRemoves duplicated preview details and links to the dedicated Gizmo and asset-preview documentation.
docs/source/tutorial/gizmo.rstConnects the tutorial to the feature guide and updates its literal-include marker to match the current script.

Reviews (1): Last reviewed commit: "docs(interaction): reorganize interactio..." | Re-trigger Greptile

@yuecideng
yuecideng merged commit 3d1827f into mainAug 12, 2026
5 checks passed
@yuecideng
yuecideng deleted the docs/interaction-documentation branch August 12, 2026 07:12
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docsImprovements or additions to documentationinteractionThe interaction simulation featuresvisualizationFeatures or functions for visualization with the simulation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@yuecideng