Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[docs][core] Improve Compiled Graphs docs #50627

Merged
merged 11 commits into from
Feb 25, 2025

Conversation

stephanie-wang
Copy link
Contributor

Why are these changes needed?

A few improvements:

  • Add more content from dev guide
  • Wording
  • Merge profiling and visualization pages, and remove parts that are difficult to understand
  • Merge execution page into quickstart page

Checks

  • I've signed off every commit(by using the -s flag, i.e., git commit -s) in this PR.
  • I've run scripts/format.sh to lint the changes in this PR.
  • I've included any doc changes needed for https://docs.ray.io/en/master/.
    • I've added any new APIs to the API Reference. For example, if I added a
      method in Tune, I've added it in doc/source/tune/api/ under the
      corresponding .rst file.
  • I've made sure the tests are passing. Note that there might be a few flaky tests, see the recent failures at https://flakey-tests.ray.io/
  • Testing Strategy
    • Unit tests
    • Release tests
    • This PR is not tested :(

Signed-off-by: Stephanie wang <smwang@cs.washington.edu>
Copy link
Contributor

@ruisearch42 ruisearch42 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks! LG

Copy link
Contributor

@dayshah dayshah left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

some build failures that should be fixed by the comments

/home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/checkouts/50627/doc/source/ray-core/compiled-graph/quickstart.rst:57: WARNING: Enumerated list ends without a blank line; unexpected unindent.

/home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/checkouts/50627/doc/source/ray-core/compiled-graph/quickstart.rst:153: WARNING: Inline literal start-string without end-string.

/home/docs/checkouts/readthedocs.org/user_builds/anyscale-ray/checkouts/50627/doc/source/ray-core/compiled-graph/quickstart.rst:266: WARNING: Inline literal start-string without end-string.

Copy link
Member

@kevin85421 kevin85421 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The Ray documentation team recommends using Vale, which defines several writing rules, such as avoiding the use of “we,” “will,” and parentheses, among others.

stephanie-wang and others added 5 commits February 24, 2025 16:35
Co-authored-by: Dhyey Shah <dhyey2019@gmail.com>
Signed-off-by: Stephanie Wang <smwang@cs.washington.edu>
Co-authored-by: Dhyey Shah <dhyey2019@gmail.com>
Signed-off-by: Stephanie Wang <smwang@cs.washington.edu>
Co-authored-by: Dhyey Shah <dhyey2019@gmail.com>
Signed-off-by: Stephanie Wang <smwang@cs.washington.edu>
Signed-off-by: Stephanie wang <smwang@cs.washington.edu>
Copy link
Contributor

@edoakes edoakes left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great

.. _compiled-graph-overlap:

Experimental: Overlapping communication and computation
=======================================================

Compiled Graph currently provides experimental support for GPU communication and computation overlap. When you turn this feature on, it automatically overlaps the GPU communication with computation operations, thereby hiding the communication overhead and improving performance.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

curious, why is this an experimental feature // not turned on by default? is there a behavior difference, or just not stable yet?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's not stable yet.

stephanie-wang and others added 2 commits February 24, 2025 17:52
Co-authored-by: Edward Oakes <ed.nmi.oakes@gmail.com>
Signed-off-by: Stephanie Wang <smwang@cs.washington.edu>
@stephanie-wang stephanie-wang enabled auto-merge (squash) February 25, 2025 01:55
@github-actions github-actions bot added the go add ONLY when ready to merge, run all tests label Feb 25, 2025
Signed-off-by: Edward Oakes <ed.nmi.oakes@gmail.com>
@github-actions github-actions bot disabled auto-merge February 25, 2025 14:22
@edoakes edoakes enabled auto-merge (squash) February 25, 2025 14:27
@edoakes
Copy link
Contributor

edoakes commented Feb 25, 2025

Pushed two commits to fix docs build

@edoakes edoakes merged commit 9f06ad9 into ray-project:master Feb 25, 2025
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
go add ONLY when ready to merge, run all tests
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants