Add new examples to documentation (15, 16, 17, 20, and 21)

[Copilot]

Overview

This PR adds documentation for five new examples that were recently added to the repository but were missing from the documentation files. The PR also syncs with the main branch to include the latest examples.

Changes

New Examples Added to Documentation

1. 15_gemm_all_reduce_ring_based: Matrix multiplication with ring-based all-reduce communication pattern
2. 16_all_reduce_ring_based: Ring-based all-reduce operation for distributed computing
3. 17_gemm_one_shot_all_reduce_pc: Matrix multiplication with one-shot all-reduce using producer-consumer pattern with two distribution modes (striding and block)
4. 20_gemm_all_scatter_independent: Independent GEMM and all-scatter operations with support for CSV input configurations (was in examples/README.md but missing from docs/reference/examples.md)
5. 21_gemm_one_shot_all_reduce_independent: Independent GEMM and all-reduce operations with support for CSV input configurations and selective execution

Files Updated

• docs/reference/examples.md: Added links and descriptions for examples 15, 16, 17, 20, and 21 in the GEMM Operations section
• examples/README.md:
  • Added directory listings for examples 15, 16, 17, and 21 in the GEMM Operations section
  • Added usage examples showing how to run the benchmark scripts for all new examples
  • Merged with main branch to include usage examples and CSV configuration documentation for examples 17 and 21

Example Usage

The new examples can be run as follows:

# Ring-based all-reduce for GEMM
python examples/15_gemm_all_reduce_ring_based/benchmark.py --benchmark --validate --num_ranks 8

# Ring-based all-reduce
python examples/16_all_reduce_ring_based/benchmark.py --benchmark --validate --num_ranks 8

# One-shot all-reduce with producer-consumer pattern
python examples/17_gemm_one_shot_all_reduce_pc/benchmark.py --benchmark --validate --num_ranks 8 --distribution 0

# Independent GEMM and all-reduce
python examples/21_gemm_one_shot_all_reduce_independent/benchmark.py --benchmark --validate --num_ranks 8

All example directories are now properly documented and accessible to users through both the main documentation site and the examples README.

Fixes #259

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Add new examples to docs and readmes</issue_title>
<issue_description>We added a few new examples but we didn’t update and add links to them in our docs. Add links to new examples</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes #259

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[mawad-amd]

@copilot sync with main and add all new examples

[Copilot]

@copilot sync with main and add all new examples

Synced with main branch and added all new examples to documentation. Commit 5011648 includes:

• Merged main branch
• Added example 17 (gemm_one_shot_all_reduce_pc) to both documentation files
• Added example 21 (gemm_one_shot_all_reduce_independent) to both documentation files

All 20 example directories are now documented in docs/reference/examples.md and examples/README.md.

[Copilot]

Pull Request Overview

This PR adds documentation for five new examples (15, 16, 17, 20, and 21) that were recently added to the repository but were missing from the documentation files.

• Updates docs/reference/examples.md to include links and descriptions for the new examples
• Updates examples/README.md to add usage commands for examples 15 and 16
• Ensures all new examples are properly documented and accessible to users

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
examples/README.md	Added usage examples for ring-based all-reduce examples (15 and 16)
docs/reference/examples.md	Added documentation links and descriptions for examples 15, 16, 17, 20, and 21 in the GEMM Operations section