1 more doc revamp

[msaroufim]

Big revamp before PTC, will probably do a few more. but repo has changed quite a bit recently so this reflects the work people are actually using

[pytorch-bot]

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/ao/745

• 📄 Preview Python docs built from this PR

Note: Links to docs will display an error until the docs builds have been completed.

✅ You can merge normally! (9 Unrelated Failures)

As of commit e6fecb0 with merge base af68031 ():

FLAKY - The following jobs failed but were likely due to flakiness present on trunk:

• Run Float8 Tests / test (SM-89, amz2023.linux.g6.4xlarge.experimental.nvidia.gpu, --pre torch --index-url https://do... / linux-job (gh) (detected as infra flaky with no log or failing log classifier)
• Run Regression Tests / test (CPU 2.2.2, linux.4xlarge, torch==2.2.2 --index-url https://download.pytorch.org/whl/cpu "nu... / linux-job (gh) (detected as infra flaky with no log or failing log classifier)
• Run Regression Tests / test (CPU 2.3, linux.4xlarge, torch==2.3.0 --index-url https://download.pytorch.org/whl/cpu, cpu) / linux-job (gh) (detected as infra flaky with no log or failing log classifier)
• Run Regression Tests / test (CPU 2.4, linux.4xlarge, torch==2.4.0 --index-url https://download.pytorch.org/whl/cpu, cpu) / linux-job (gh) (detected as infra flaky with no log or failing log classifier)
• Run Regression Tests / test (CPU Nightly, linux.4xlarge, --pre torch --index-url https://download.pytorch.org/whl/nightl... / linux-job (gh) (detected as infra flaky with no log or failing log classifier)
• Run Regression Tests / test (CUDA 2.2.2, linux.g5.12xlarge.nvidia.gpu, torch==2.2.2 "numpy<2" , cuda, 12.1) / linux-job (gh) (detected as infra flaky with no log or failing log classifier)
• Run Regression Tests / test (CUDA 2.3, linux.g5.12xlarge.nvidia.gpu, torch==2.3.0, cuda, 12.1) / linux-job (gh) (detected as infra flaky with no log or failing log classifier)
• Run Regression Tests / test (CUDA 2.4, linux.g5.12xlarge.nvidia.gpu, torch==2.4.0, cuda, 12.1) / linux-job (gh) (detected as infra flaky with no log or failing log classifier)
• Run Regression Tests / test (CUDA Nightly, linux.g5.12xlarge.nvidia.gpu, --pre torch --index-url https://download.pytorc... / linux-job (gh) (detected as infra flaky with no log or failing log classifier)

This comment was automatically generated by Dr. CI and updates every 15 minutes.

[supriyar]

left a few comments to address. Other than that lgtm!