[Docs] Streamline getting-started pages

[StafaH]

Description

Streamlines the getting-started documentation and points environment discovery to the interactive browser.

• Refreshes the quickstart GIFs with OVRTX rendering.
• Uses the Franka drawer task for the zero, random, and trained-policy comparison.
• Adds a page-scoped generator at tools/docs/media/generate_quickstart.sh so the media can be reproduced.
• Preserves environment-browser preview assignments without the removed catalog page.

Validation

• tools/docs/media/generate_quickstart.sh
• uv run --frozen isaaclab -f
• uv run --frozen --isolated --extra test -- make -C docs current-docs
• Existing focused environment-browser checks

[greptile-apps]

Greptile Summary

This PR consolidates environment discovery into the interactive browser and moves scripted state-machine instructions into a focused how-to guide.

• Removes the legacy environment catalog and simple-agent overview pages while updating documentation and skill references.
• Adds two quickstart GIFs illustrating agent behavior and representative tasks.
• Changes environment-browser generation to preserve preview images from existing generated rows, with focused tests.

Confidence Score: 4/5

The documentation move needs its remaining README link updated or the old published URL redirected before merging.

Deleting the environment catalog removes the target of a current repository link, so users following that documented entry point will receive a 404.

Files Needing Attention: docs/source/overview/environments.rst and README.md

Important Files Changed

Filename	Overview
docs/source/overview/environments.rst	Deletes the legacy catalog, but its published URL remains linked from README.md without a redirect.
tools/environ_docs.py	Moves preview-image collection to generated browser rows while retaining correct compatibility and image field positions.
tools/update_environments_rst.py	Simplifies regeneration to update only the environment-browser JavaScript.
tools/test/test_environ_docs.py	Adds focused coverage for preserving preview assignments from generated browser rows.
docs/source/how-to/run_state_machines.rst	Adds runnable state-machine examples whose documented script paths and arguments match the current entry points.
docs/source/setup/quickstart.rst	Adds compact task and agent demonstrations and redirects environment discovery to the browser.

Comments Outside Diff (1)

1. docs/source/overview/environments.rst

   Deleted environment documentation URL

   When a user follows the environment documentation link retained in README.md or an existing bookmark, deleting this page removes /source/overview/environments.html, causing a 404 instead of opening the replacement environment browser. Update the remaining link and preserve the published URL with a redirect.

_{Reviews (1): Last reviewed commit: "Streamline getting-started documentation" | Re-trigger Greptile}

[isaaclab-review-bot]

Isaac Lab Review Bot

The documentation consolidation consistently redirects environment references to the generated browser and preserves preview assignments during regeneration. One cleanup remains: the deleted RST catalog’s generation helpers, markers, and tests are still retained as dead infrastructure.

• Design and architecture: Using the environment-browser rows as the source for both selectors and preview assignments removes the catalog dependency. However, retaining the obsolete comprehensive-list pipeline leaves two apparent documentation architectures and creates avoidable maintenance ambiguity.
• API: The updater CLI intentionally removes the obsolete RST output while preserving --check and --browser_output. The replacement preview-image helper is consistently used by the updater and its focused test.
• Implementation: The browser parser and renderer support the preview-preservation round trip. Remove the now-unused comprehensive RST markers, rendering and patching helpers, and their catalog-specific tests from tools/environ_docs.py and tools/test/test_environ_docs.py.

Minor fixes needed. Posted 1 actionable finding inline.

Automated review; human maintainers own approval decisions.

[isaaclab-review-bot]

🔵 Suggestion · Implementation — Unused RST table generators kept after page deletion

docs/source/overview/environments.rst is deleted and update_environments_rst.py no longer imports render_comprehensive_list_table, patch_environments_rst, or patch_curated_environment_tables, yet these helpers and the COMPREHENSIVE_LIST_* markers stay exported and are still exercised by tools/test/test_environ_docs.py. They now target a file that cannot exist, leaving maintenance burden and a misleading picture of the docs pipeline. Consider removing them and their tests with the page.