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] Fix Data examples TOC and rendering #36404

Merged
merged 3 commits into from
Jun 14, 2023

Conversation

amogkam
Copy link
Contributor

@amogkam amogkam commented Jun 14, 2023

b10f19d renamed the examples file for Ray Data.

We have to make the corresponding change to the TOC, so that the page still shows up on the docs.

Also removes the example files from exclude_patterns so they are built correctly.
Includes the examples in a hidden toctree to prevent sphinx warnings.

Why are these changes needed?

Related issue number

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: amogkam <amogkamsetty@yahoo.com>
@amogkam amogkam requested a review from a team as a code owner June 14, 2023 01:26
@@ -96,7 +96,7 @@ parts:
- file: data/getting-started
- file: data/key-concepts
- file: data/user-guide
- file: data/examples
- file: data/data_examples
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
- file: data/data_examples
- file: data/data_examples
title: Examples

Copy link
Contributor

Choose a reason for hiding this comment

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

Are you open to keeping the name the same?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

The name isn't changed in this PR. It's still being pulled from the title of data_examples.rst

Copy link
Contributor

Choose a reason for hiding this comment

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

I think you can set it with that title line, no?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

If not provided, it will default to the title in the rst file

Signed-off-by: amogkam <amogkamsetty@yahoo.com>
Signed-off-by: amogkam <amogkamsetty@yahoo.com>
@amogkam amogkam changed the title [Docs] Fix Data examples TOC [Docs] Fix Data examples TOC and rendering Jun 14, 2023
Copy link
Contributor

@maxpumperla maxpumperla left a comment

Choose a reason for hiding this comment

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

Thanks! this is obviously much better.

Comment on lines +10 to +20
.. toctree::
:hidden:

huggingface_vit_batch_prediction
pytorch_resnet_batch_prediction
batch_inference_object_detection
nyc_taxi_basic_processing
batch_training
ocr_example
random-access
custom-datasource
Copy link
Member

Choose a reason for hiding this comment

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

These will show up in the navbar.

Copy link
Contributor Author

@amogkam amogkam Jun 14, 2023

Choose a reason for hiding this comment

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

yep, as you mentioned offline, doesn't seem there's an easy way to avoid this

@amogkam amogkam merged commit 0f761f4 into ray-project:master Jun 14, 2023
@amogkam amogkam deleted the fix-data-examples branch June 14, 2023 20:04
arvind-chandra pushed a commit to lmco/ray that referenced this pull request Aug 31, 2023
b10f19d renamed the examples file for Ray Data.

We have to make the corresponding change to the TOC, so that the page still shows up on the docs.

Also removes the example files from exclude_patterns so they are built correctly.
Includes the examples in a hidden toctree to prevent sphinx warnings.

---------

Signed-off-by: amogkam <amogkamsetty@yahoo.com>
Signed-off-by: e428265 <arvind.chandramouli@lmco.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants